NdisDeregisterProtocol

VOID

  NdisDeregisterProtocol(

    OUT PNDIS_STATUS  Status,

    IN NDIS_HANDLE  NdisProtocolHandle

    );

NdisDerigisterProtocol은 드라이버가 NdisRegisterProcol을 호출했을때 할당한 리소스들을 해제한다.

매개변수

Status
이함수로 부터리턴될때 NDIS_STATUS_SUCCESS로설정되는 호출자제공 변수포인터이다.

NdisProtocolHandle
드라이버가 초기화했을때 NdisRegisterProtocol에 의해 리턴된 핸들을 지정한다.

주석

등록된 프로토콜드라이버는 NdisDeregisterProtocol을 다음과 같은 환경에서 호출한다.

  • 드라이버가 이미 NdisRegisterProtocol을 성공적으로 호출했지만 머신내에서 어떤 하위 NDIS드라이버와 바인딩 할수 없을때.

  • 드라이버가 언로드 돼고있을때. 즉, 초기화하는동안 드라이버오브젝트안에 설정된 언로드루틴이 호출되거나, ProtocolUnbindAdapter함수가 드라이버의 last remaining binding을 해제하기위해 호출될때.

    언로드루틴과 다른 표준 커널모드 드라이버루틴에 대해서는 Kenel-Mode Driver DesignGuide를 보아라.

  • 시스템은 셧다운 될것이다. 왜냐하면 상위레벨프로토콜드라이버는 초기화 할때 IoRegisterShutdownNotification을 호출하기때문에, 그셧다운루틴은 호출된다.

    IoRegisterShutdownNotification에 대한 더많은 정보는 Kernel-Mode Driver Reference를 보아라.

만약 프로토콜이 어떤 열린바인딩들을 가지고 있다면, NdisDeregisterProtocol의 호출은 NDIS에게 프로토콜의 ProtocolUnbindAdapter함수를 각 열려진바인딩당 한번씩 호출하도록한다. ProtocolUnbindAdapter는 바인딩을 닫기위해 NdisCloseAdapter함수를 호출한다.

현재 열린바인딩이 닫혀질때, NdisDeregisterProtocol함수는 호출자가 설정한 모든 필터들을 해제하고 NDIS가 프로토콜드라이버를 위한 바인딩들과 필터들을 트랙하기위해 할당한 메모리를 해제한다.

NdisDeregisterProtocol의 호출자는 IRQL이 DISPATCH_LEVEL보다 낮은레벨에서 동작한다.