NdisMRegisterUnloadHandler

VOID NdisMRegisterUnloadHandler( IN NDIS_HANDLE NdisWrapperHandle, IN PDRIVER_UNLOAD UnloadHandler );

NdisMRegisterUnloadHandler 함수는 드라이버를 위해 unload 핸들러를 등록한다.

매개변수

NdisWrapperHandle

NdisMInitializeWrapper 함수에 의해 리턴된 핸들을 지정한다.

UnloadHandler

드라이버의 unload 루틴을 위한 엔트리 포인트를 지정한다. unload 루틴은 다음과 같이 선언된다.

VOID

(*PDRIVER_UNLOAD) (

    IN struct _DRIVER_OBJECT *DriverObject

    );

주석

드라이버는 DriverEntry 함수가 NdisMInitializeWrapper 함수를 호출한 후에 DriverEntry 함수로부터 NdisMRegisterUnloadHandler 함수를 호출한다. NdisMRegisterUnloadHandler 함수는 드라이버를 위해 unload 핸들러를 등록한다.

unload 핸들러의 기능은 드라이버 특정이다. 예를 들어, 인터미디엇 드라이버는 인터미디엇 드라이버의 프로토콜 부분을 등록 해제하기 위해 NdisDeregisterProtocol 함수를 호출하는 unload 핸들러를 등록해야 한다. unload 핸들러는 또한 드라이버의 프로토콜 부분에 의해 사용된 자원들을 할당해제하는 것처럼 어떤 필요한 cleanup 연산들을 행해야 한다.

load balancing 미니포트와 같은 하나의 미니포트 인스턴스 이상을 모니터하는 미니포트는 상태 정보를 지우는 unload 핸들러를 등록해야 하고 모니퍼하는 미니포트 인스턴스들이 halt된 후에, 자원들을 해제해야 하는 unload 핸들러를 등록해야 한다. unload 핸들러는 MiniportHalt 함수와는 다르다는 것을 주의하라. : unload 핸들러는 MiniportHalt 함수의 scope가 특히 미니포트 인스턴스에 제한된 반면에 더 전체적인 scope를 가진다.

NdisMRegisterUnloadHandler 함수의 호출자들은 IRQL PASSIVE_LEVEL 에서 실행한다.