MiniportHalt

VOID MiniportHalt( IN NDIS_HANDLE MiniportAdapterContext );

MiniportHalt는 NIC이 제거될 때 그리고 NIC을 halt할 때 자원을 해제하는 요구된 함수이다.

매개변수

MiniportAdapterContext

드라이버가 MiniportInitialize에 의해 설정되어지는 NIC 상태당 유지하는 미니포트 할당 컨텍스트 영역에 대한 핸들을 지정한다.

주석

MiniportHalt는 만약 실제 NIC이 제어한다면은 NIC을 멈쳐야 하고, MiniportHalt가 제어를 리턴하기 전에 NIC을 위해 드라이버가 할당한 모든 자원을 해제해야 한다.

만약 NIC 드라이버가 메모리를 할당하고 I/O 포트 범위, 호스트에 대한 맵된 on-board 장치 메모리, 초기화된 타이머와 스핀락 할당된 맵 레지스트 혹은 요구된 DMA 채널, 인터럽트들을 할당한다면은 그러한 드라이버는 원래 이러한 자원들을 할당한 NdisXxx 함수들을 호출해야 한다.

일반적인 규칙으로, MiniportHalt 함수는 MiniportInitialize로부터 호출되어진 역순으로 NdisXxx 함수들을 호출해야 한다. 즉, 만약 NIC 드라이버의 MiniportInitialize 함수가 NdisMRegisterAdapterShutdownHandler를 제어를 리턴하기 전에 호출한다면은 MiniportHalt 함수는 처음 NdisMDeregisterAdapterShutdownHandler을 호출할 것이다.

만약 NIC이 인터럽트들을 발생하거나 혹은 IRQ를 공유한다면은, NIC 드라이버의 MiniportHalt 함수는 MiniportHalt 함수가 NdisMDeregisterInterrupt 함수를 호출할 때까지 MiniportDisableInterrupt 함수 혹은 MiniportISR에 의해 선점되어질 수 있다. 그러한 드라이버의 MiniportHalt 함수는 항상 가능하다면은 NIC에 대한 인터럽트들을 디스에이블하고 가능한한 빨리 NdisMDeregisterInterrupt를 호출한다.

만약 드라이버가 시스템 타이머 큐에 있는 어떤 타이머 객체와 관련된 MiniportTimer 함수를 가진다면은 MiniportHalt는 NdisMCancelTimer를 호출해야 한다.

그렇지 않는다면은 미니포트가 MiniportHalt가 할당된 자원들을 해제하기 시작하기 전에 NIC에 대한 요구들을 완성하는 것이 불필요하다. NDIS는 더 이상 미니포트에게 NDIS가 MiniportHalt를 호출할 때 MiniportAdapterContext 핸들에 의해 위임된 NIC을 위해 미니포트에 대한 요구들이 더이상 제출되지 않는다. MiniportHalt로부터의 리턴하자마자, NDIS는 만약 미니포트가 현 컴퓨터에서 다른 NIC들을 위해 어떤 지원들이 없다면은 드라이버와 NIC에 대해 유지해온 어떤 상태를 지운다.

NdisIMDeinitializeDeviceInstance에 대한 NDIS 인터미디엇 드라이버의 호출은 MiniportHalt 함수에 대한 호출을 야기한다.

디폴트로 MiniportHalt는 IRQL PASSIVE_LEVEL에서 실행한다.