NdisMCmRegisterSapComplete

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

NdisMCmRegisterSapComplete함수는 SAP를 등록하기위해 MCM드라이버의 ProtocolCmRegisterSap함수가 이전에 NDIS_STATUS_PENDING을 리턴한것에대해 클라이언트의 요청에대한 최종 상태를 리턴한다.

매개변수

Status

SAP를 등록하기위해 클라이언트의 처음 요청에대한 최종 상태를 지정한다. NDIS_STATUS_SUCCESS혹은 NDIS_STATUS_PENDING을 제외한 호출자 의존 NDIS_STATUS_XXX.

NdisSapHandle

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

CallMgrSapContext

MCM미니포트가 만약 등록이 성공하면 이 SAP에대한 상태를 유지하는 호출자 제공 상주 컨텍스트 영역에대한 핸들을 지정한다. 만약 그렇다면, NDIS는 이 핸들을 이 SAP를 고려하는 모든 순차적인 호출들에서 MCM드라이버에게 다시 넘긴다. 만약 Status가 NDIS_STATUS_SUCCESS이외의 다른것으로 설정됐다면, NDIS는 이 파라미터를 무시한다.

주석

MCM드라이버는 만약 ProtocolCmRegisterSap함수가 주어진 NdisSapHandle로 호출되었을때 NDIS_STATUS_PENDING을 리턴한다면 NdisMCmRegisterSapComplete함수를 호출해야만 한다. NdisMCmRegisterSapComplete함수에대한 호출은 NDIS로 하여금 클라이언트의 ProtocolClRegisterSapComplete함수를 호출하도록 한다.

만약 MCM드라이버가 Status를 NDIS_STATUS_SUCCESS이외의 다른것으로 설정한다면, NdisMCmRegisterSapComplete함수가 컨추럴을 리턴할때 NdisSapHandle은 무효한것으로 간주되어야 한다. SAP등록 실패후, CM은 이미 할당된 SAP당 컨텍스트 영역을 해제하거나 재상용 할수 있다. NDIS는 또한 만약 MCM미니포트가 등록을 실패한다면, SAP에대한 컨텍스트를 해제한다.

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

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