MiniportDisableInterrupt

VOID MiniportDisableInterrupt( IN NDIS_HANDLE MiniportAdapterContext );

MiniportDisableInterrupt는 IRQ를 공유하지 않고 동적으로 인터럽트들을 가능하게 하고 불가능하게 하는 것을 지원하는 NIC 드라이버들에 의해 제공되어지는 선택적인 함수이다.

매개변수

MiniportAdapterContext

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

주석

MiniportDisableInterrupt는 전형적으로 NIC에 마스크를 씀으로써 인터럽트들을 불가능하게 한다. 만약 드라이버가 이 함수를 가지지 않는다면은, 전형적으로 MiniportISR은 NIC에게 인터럽트들을 불가능하게 한다.

만약 NIC이 인터럽트들을 동적으로 가능하게 그리고 불가능하게 하는 것을 지원하지 않거나 IRQ를 공유한다면은, NIC 드라이버는 MiniportISR 함수를 등록해야 하고 RequestIsr를 NdisMRegisterMiniport를 호출할 때, TRUE로 설정해야 한다. 그러한 드라이버의 MiniportISR 함수는 NIC에 의해 발생된 각 인터럽트를 인식해야 하고 드라이버의 MiniportHandleInterrupt 함수를 위한 어떤 필요한 인터럽트 정보를 저장해야 한다.

디폴트로, NIC 드라이버의 MiniportInitialize 함수가 NdisMRegisterInterrupt를 호출할 때, DIRQL에서 특히, MiniportDisableInterrupt를 DIRQL에서 실행한다. 그러므로, MiniportDisableInterrupt는 어떤 IRQL에서도 호출하는데 안전한 NdisRawXxx 함수들과 같은 NDIS 라이브러리 함수들의 서브셋을 호출할 수 있다.

MiniportDisableInterrupt가 NIC레지스터들과 같은 자원들을 낮은 IRQL에서 실행하는 또 하나의 MiniportXxx와 공유한다면은, 그러한 MiniportXxxx는 NdisMSynchronizeWithInterrupt를 호출해서 드라이버의 MiniportSynchronizeISR 함수는 동기화된 그리고 멀티프로세서 안전 방법으로 NDIS 라이브러리 함수들의 서브셋을 호출할 수 있다. 그렇지 않다면은, 공유된 자원들을 접근하는 동안, 그러한 MiniportXxx 함수는 가능한한 MiniportXxx에 의해 행해진 작업들을 원상 복구함으로써(undoing) MiniportDisableInterrupt에 의해 선점될 수 있다.