MiniportShutdown

VOID MiniportShutdown( IN PVOID ShutdownContext );

MiniportShuwdown은 사용자에 의해 혹은 회복할 수 없는 시스템 에러가 발생할 때 시스템이 셧다운될 때 NIC을 초기 상태로 회복하는 선택적인 함수이다.

매개변수

ShutdownContext

NIC 드라이버의 MiniportInitialize함수가 NdisMRegisterAdapterShutdownHandler가 호출할 때 제공되어지는 컨텍스트 영역을 가리킨다. 항상, 입력 변수는 다른 MiniportXxx 함수들에 전달되어지는 NIC 특정 MiniportAdapterContext 포인터이다.

주석

모든 NIC 드라이버는 MiniportShutdown 함수를 가져야 한다. MiniportShutdown 함수는 단지 NIC을 초기화상태로 회복한다.(미니포트의 DriverEntry 함수가 실행하기 전에) 그러나 이것은 NIC이 알려진 상태로 되게 해야 하고 컴퓨터가 시스템 클래쉬를 포함해 어떤 이유로해서 시스템 셧다운이 일어난 후 재부트될 때 재초기화할 준비가 되게 해야 한다.

NIC 드라이버의 MiniportInitialize 함수는 MiniportShutdown 함수를 설정하기 위해 NdisMRegisterAdapterShutdownHandler를 호출해야 한다. 드라이버의 MiniportHalt 함수는 NdisMDeregisterAdapterShutdownHandler에 대한 상호 호출을 해야 한다.

만약 MiniportShutdown함수가 사용자 초기화 시스템 셧다운으로 인해 호출되어진다면은 시스템 쓰레드 컨텍스트 내에서 IRQL PASSIVE_LEVEL에서 실행한다. 만약 회복할 수 없는 에러로 호출되어진다면은, MiniportShutdown은 조정된 IRQL에서 실행되고 어떤 컨포넌트에서 에러를 발생한 컨텍스트내에서 실행된다. 예를 들면은, MiniportShutdown은 시스템의 계속된 실행에 필수인 장치를 위한 ISR의 컨텍스트내에서 높은 DIRQL에서 실행할 것이다.

MiniportShutdown이 조정된 IRQL에서 실행되기 때문에, 어떤 IRQL에서 호출에 대한 안전한 NdisXxx 함수들만 단지 호출할 수 있다.