NdisMInitializeTimer

VOID NdisMInitializeTimer( IN OUT PNDIS_MINIPORT_TIMER Timer, IN NDIS_HANDLE MiniportAdapterHandle, IN PNDIS_TIMER_FUNCTION TimerFunction, IN PVOID FunctionContext );

NdisMInitializeTimer는 드라이버의 MiniportTimer 함수와 관련된 타이머 객체를 초기화한다.

매개변수

Timer

타이머 객체를 위한 호출자 제공, 상주 공간을 가리킨다. 타이머 객체는 호출자에 불분명하지만은, 초기화되어질 때 이 포인터는 NdisM..Timer 함수들에 대한 필요한 매개변수이다.

MiniportAdapterHandle

MiniportInitialize에 들어오는 핸들을 가리킨다.

TimerFunction

호출자 제공 MiniportTimer 함수의 엔트리 포인트를 지정한다.

FunctionContext

호출될 때 주어진 MiniportTimer 함수에 전달되어지는 호출자 제공 컨텍스트 영역를 가리킨다.

주석

NdisMSetAttributes(Ex)를 호출한 후, 미니포트의 MiniportInitialize 함수는 MiniportTimer 함수들을 설정하기 위해 NdisMInitializeTimer를 호출할 수 있다. MiniportInitialize는 드라이버가 어떤 다른 NdisM..Timer 함수에 대한 MiniportTimer 포인터를 전달하기 전에 NdisMInitializeTimer를 호출해야 한다.

인터럽트를 발생하지 않는 NIC드라이버들은 적어도 들어오는 리시브들과 보내는 완성들을 위해 NIC 상태를 모니터하는 폴링 MiniportTimer 함수를 위해 타이머 객체를 초기화해야 한다.

NdisMSet..Timer 함수들에 대한 호출은 시스템 타이머 큐에 타이머 객체를 삽입한다. NdisMCancelTimer에 대한 호출은 만약 현재 큐에 저장된다면은 타이머 객체를 큐에서 제거한다. 단지 특정 타이머 객체의 하나의 인스턴스가 어떤 주어진 순간에 큐에 저장될 수 있다.

드라이버가 NdisMSetTimer을 호출할 때, Timer 에 타이머 객체는 호출에서 지정된 시간 간격이 완료될 때 큐에 저장되어진다. 완성될 때, 타이머 객체는 큐에서 해제되고 호출자 제공 TimerFunction은 프로세서가 이용될 때마다 IRQL DISPATCH_LEVEL에서 즉시 실행된다. 드라이버가 NdisMSetPeriodicTimer를 호출할 때, 타이머 객체는 큐에서 해제되고 호출자 제공 TimerFunction은 주어진 시간 간격이 완료될 때 실행된다. 그러나 타이머 객체는 자동적으로 다시 같은 고정 시간 간격에서 큐에 저장되고 MiniportTimer 함수는 주기적으로 IRQL DISPATCH_LEVEL에서 실행한다.

MiniportInitialize 함수는 다른 MiniportTimer 함수와 관련된 각각, 하나의 타이머 객체 이상을 초기화하기 위해 한 번 이상 NdisMInitializeTimer를 호출할 수 있다. 예를 들어, NIC 드라이버는 주기적으로 NIC 상태를 폴하는 하나의 MiniportTimer 함수를 가져야 한다. 그리고 미니포트가 주기적으로 단지 NIC에 특정 연산을 타임아웃하기 위해 사용하는 또 하나의 함수를 가져야 한다. 각 그러한 MiniportTimer 함수는 다른 기능을 가진다. 각각 그러한 함수는 MiniportInitialize로부터 NdisMInitializeTimer 호출함으로써 다른 타이머 객체와 관련되어진다.

NdisMInitializeTimer는 IRQL PASSIVE_LEVEL에서 실행한다.