ProtocolClDeregisterSapComplete

VOID ProtocolClDeregisterSapComplete( IN NDIS_STATUS Status, IN NDIS_HANDLE ProtocolSapContext );

들어오는 호출들을 수락하는 연결 지향 NDIS 클라이언트들은 그들이 NdisClDeregisterSap 함수로 초기화한 비동기 연산들을 완성하기 위해 ProtocolClDeregisterSapComplete 함수를 가져야 한다. 그렇지 않으면, 그러한 프로토콜 드라이버의 등록된 ProtocolClDeregisterSapComplete 함수를 간단히 제어를 리턴할 수 있다.

매개변수

Status

다음과 같은 하나값을 가질 수 있는 SAP를 등록해제하기 위한 클라이언트 요구의 마지막 상태를 지정한다.

NDIS_STATUS_SUCCESS

SAP는 닫혔다. 클라이언트가 ProtocolSapContext 영역내에 저장한 클라이언트의 전에 등록된 SAP를 표시하는 NdisSapHandle은 지금 유효하지 않는다.

NDIS_STATUS_FAILURE

NDIS는 NdisSapHandle에 의해 표시된 관련 SAP가 이미 NdisClDeregister함수에 대한 클라이언트의 호출이 발생할 때, 해제되기 위해 AF의 상태를 "closing"으로 마크한다.

NDIS_STATUS_XXX

콜 매니저는 몇몇 CM-결정 이유를 위해 SAP를 닫기 위한 요구가 실패하고 NDIS는 클라이언트에게 ProtocolCmDeregisterSap 함수에 의해 리턴된 상태를 전파한다.(propagated).

ProtocolSapContext

원래 NdisClRegisterSap 함수로 NDIS에게 전달된 SAP 당 컨텍스트 영역에 대한 클라이언트 제공 핸들을 지정한다. 콜 매니저는 성공적으로 이러한 SAP를 등록 해제한 후, 클라이언트는 컨텍스트 영역을 해제할 수 있고 재사용을 위해 이러한 컨텍스트 영역을 준비한다.

주석

ProtocolClDeregisterSapComplete 함수에 대한 호출은 NdisClDeregisterSap에 대한 클라이언트의 선행 호출이 콜 매니저에 의해 처리되는 것을 가리킨다.

만약 콜 매니저가 몇몇 CM-결정 이유를 위해 등록 해제가 실패되지 않는다면, 클라이언트는 ProtocolClDeregisterSapComplete 함수가 호출될 때 NdisSapHandle이 유효하지 않다는 것을 고려해야 한다. 결과적으로, ProtocolClDeregisterSapComplete 함수는 클라이언트가 할당한 SAP당 컨텍스트 영역을 해제할 수 있거나 NdisClRegisterSap 함수에 대한 계속적인 호출에서 재사용을 위해 준비할 수 있다.

ProtocolClDeregisterSapComplete 함수는 IRQL DISPATCH_LEVEL에서 실행할 수 있게 하기 위해 쓰여져야 한다.