NdisCmRegisterSapComplete

VOID NdisCmRegisterSapComplete( IN NDIS_STATUS Status, IN NDIS_HANDLE NdisSapHandle, IN NDIS_HANDLE CallMgrSapContext );

NdisCmRegisterSapComplete함수는 SAP를 등록 하기위해 CM이 이전에 NDIS_STATUS_PENDING를 리턴한 것에대한 클라이언의 요청의 마지막 상태를 리턴한다.

매개변수

Status

SAP를 등록 하기위한 클라이언트의 처음 요청의 마지막 상태를 지정한다. NDIS_STATUS_SUCCESS혹은 NDIS_STATUS_PENDING를 제외한 어떤 CM의존 NDIS_STATUS_XXX.

NdisSapHandle

만약 등록이 성고이라면 NDIS지원 SAP핸들을 지정한다. 콜 매니저는 ProtocolCmRegisterSap함수에대한 입력 파라미터로써 이 핸들을 얻는다.

CallMgrSapContext

만약 등록이 성공이라면, CM이 이 SAP에대한 상태를 유지하는 호출자 지원 상주 컨텍스트 영역에 대한 핸들을 지정한다. 만약 그렇다면, NDIS는 이 핸들을 다시 이 SAP를 고려하는 모든 순차적인 호출내의 CM에게 이 핸들을 넘긴다. 만약 Status가 NDIS_STATUS_SUCCESS이외가 설정된다면, NDIS는 이 파라미터를 무시한다.

주석

독립적인 콜 매니저는 만약 ProtocolCmRegisterSap함수가 주어진 NdisSapHandle로 호출되었을때 NDIS_STATUS_PENDING을 리턴한다면 NdisCmRegisterSapComplete함수를 리턴해야만한다. NdisCmRegisterSapComplete함수의 호출은 NDIS로 하여금 클라이언트의 ProtocolClRegisterSapComplete함수를호출하도록 한다.

만약 콜 매니저가 Status를 NDIS_STATUS_SUCCESS이외의 다른 것으로 설정한다면, NdisCmRegisterSapComplete함수가 호출되자마자 NdisSapHandle을 무효하다고 간주한다. SAP등록 실패후, CM은 NdisCmRegisterSapComplete함수가 컨추럴을 리턴할때 할당한 SAP당 컨텍스트 영을을 해재하고나 재사용할수 있다. NDIS는 또한 콜 매니저가 등록을 실패하면 SAP에대한 컨택스트를 해재한다.

스스로를 NDIS로 프로토콜로서 등록하는 독립적인 콜 매니저만이 NdisCmRegisterSapComplete함수를 호출할수 있다. 통합 콜 매니지먼트를 지원하는 연결지향 닉 드라이버는 NdisMCmRegisterSapComplete함수를 호출한다.

NdisCmRegisterSapComplete함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 동작될수 있다.