MiniportSynchronizeISR

BOOLEAN MiniportSynchronizeISR( IN PVOID SynchronizeContext );

MiniportSynchronizeISR은 DIRQL보다 낮은 곳에서 실행하는 어떤 NIC 드라이버 함수는 그러한 드라이버의 MiniportISR 혹은 MiniportDisableInterrupt 함수와 자원들을 공유한다면은 필요한 함수이다.

매개변수

SynchronizeContext

NIC 드라이버의 MiniportXxx 혹은 내부 함수가 NdisMSynchronizeWithInterrupt를 호출할 때 제공되어지는 컨텍스트 영역을 가리킨다. 항상, 이러한 입력 매개변수는 다른 MiniportXxx 함수들에게 전달되어지는 NIC 특정 MiniportAdapterContext 영역내에 offset에서 공유된 자원들의 set에 대한 포인터이다.

리턴값

MiniportSynchronizeISR은 NdisMSynchronizeWithInterrupt의 호출자에게 전달되어지는 드라이버 결정 의미로 Boolean을 리턴한다.

주석

만약 어떤 NIC 드라이버 함수가 장치 레지스터들과 같은 자원들을 드라이버의 MiniportISR 혹은 MiniportDisableInterrupt 함수와 공유한다면은 디폴트로 DIRQL보다 낮은 곳에서 실행하는 드라이버 함수는 직접 이러한 자원들에게 접근할 수 없다. 만약 그러한 공유된 자원들을 직접 접근하는 것을 시도한다면은, 낮은 우선 순위 함수는 낮은 우선 순위 드라이버 함수아래에서부터 상태가 변화할 수 있는 MiniportISR 혹은 MiniportDisableInterrupt의 실행에 의해 선점될 수 있다.

MiniportISR 혹은 MiniportDisableInterrupt로 그러한 공유된 자원들에 대한 접근을 동기화하기 위해, 낮은 우선권 드라이버 함수들은 DIRQL 에서 이러한 공유된 자원들에 대한 드라이버의 MiniportSynchronizeISR 함수의 접근을 가지기 위해 NdisMSynchronizeWithInterrupt를 호출해야 한다. NdisMSynchronizeWithInterrupt를 호출하는 것은 SMP 기계에서 특히, 그러한 NIC 드라이버내에서 경주 조건들과(race conditions) 데드락들을 보호한다.

그들 사이에 자원들을 공유하는 어떤 낮은 우선 순위 드라이버 함수들은(DIRQL에서 실행하는 어떤 함수로가 아니라) 그러한 공유된 자원들을 보호하기 위해 스핀락을 사용해야 한다.

MiniportSynchronizeISR은 드라이버의 MiniportInitialize 함수가 NdisMRegisterInterrupt를 호출할 때 할당된 DIRQL에서 실행한다. DIRQL에서 실행하는 어떤 드라이버 함수와 같이, MiniportSynchronizeISR은 어떤 IRQL에서 호출하는데 안전하게 단지 그러한 NdisXxx 함수들을 호출할 수 있고 가능한한 빠르게 제어를 리턴해야 한다.