MiniportTimer

VOID MiniportTimer( IN PVOID SystemSpecific1, IN PVOID FunctionContext, IN PVOID SystemSpecific2, IN PVOID SystemSpecific3 );

MiniportTimer는 만약 드라이버의 NIC이 인터럽트들을 발생하지 않는다면은 필요한 함수이다. 그렇지 않은면은, 하나나 혹은 그 이상의 MiniportTimer 함수들은 선택적이다.

매개변수

SystemSpecific1

MiniportTimer에게 불분명하고 시스템 사용을 위해 예약된 시스템 특정 변수를 가리킨다.

FunctionContext

MiniportInitialize가 관련된 타이머 객체를 설정할 때 NdisMInitializeTimer에 전달되는 컨텍스트 포인터를 지정한다.

SystemSpecific2

시스템 사용을 위해 예약된 시스템 특정 값을 가리킨다.

SystemSpecific3

시스템 사용을 위해 예약된 시스템 특정 값을 가리킨다.

주석

인터럽트들을 발생하지 않는 NIC 드라이버는 NIC의 상태를 poll하기 위해 MiniportTimer 함수를 가져야 한다. 그러한 드라이버의 MiniportInitialize 함수는 NdisMInitializeTimer로 드라이버 할당 타이머 객체를 설정한 후에, NdisMSetPeriodicTimer에 대한 호출은 타이머 객체와 관련된 MiniportTimer 함수가 MillisecondsPeriod에 의해 지정된 시간간격에서 반복적이고 자동적으로 실행되어지도록 한다. 그러한 polling(폴링) MiniportTimer 함수는 인디케이션들이 있을 때, 지연 보내기가 완성될 때, 등등을 결정하기 위해 NIC의 상태를 모니터한다. 효과적으로, 그러한 polling MiniportTimer 함수는 인터럽트들이 발생하는 NIC의 드라이버에서 MiniportHandleInterrupt과 같은 기능을 가진다.

대조적으로, NdisMSetTimer를 호출하는 것은 주어진 MillisecondsToDelay가 완료될 때 일단 실행되는 타이머 객체와 관련된 MiniportTimer함수를 야기한다. 그러한 MiniportTimer 함수는 항상 만약 특정 연산이 타임아웃 되었을 때, 몇몇 드라이버 결정 행동들을 행한다.

만약 MiniportTimer 함수의 각 타입이 다른 드라이버 함수들과 자원들을 공유한다면은, 드라이버는 스핀락으로 이러한 자원들에 대한 접근을 동기화해야 한다.

어떤 NIC 드라이버 혹은 인터미디엇 드라이버는 드라이버 개발자의 discretion에서 하나 이상의 MiniportTimer 함수를 가질 수 있다. 각 그러한 MiniportTimer 함수는 드라이버 할당 그리고 초기화된 타이머 객체와 관련되어질 것이다.

NdisMCancelTimer에 대한 호출은 즉시 NdisMSetTimer에 대한 선행 호출에서 전달된 시간간격이 완료되지 않다면은 비폴링(nonpolling) MiniportTimer 함수의 실행을 취소한다. NdisMSetPeriodicTimer에 대한 호출 후에, 같은 타이머 객체로 NdisMSetTimer 혹은 NdisMCancelTimer에 대한 호출은 polling MiniportTimer 함수를 불가능하게 한다.: MiniportTimer 함수가 한번 실행되거나 혹은 취소된다.

MiniportTimer 함수를 가진 어떤 드라이버의 MiniportHalt 함수는 MiniportTimer 함수가 MiniportHalt가 이미 해제된 자원들을 접근하려고 시돌하지 않는다는 것을 확실히 하기 위해 NdisMCancelTimer를 호출해야 한다.

디폴트로, MiniportTimer는 IRQL DISPATCH_LEVEL에서 실행한다.