NdisMSetPeriodicTimer

VOID NdisMSetPeriodicTimer( IN PNDIS_MINIPORT_TIMER Timer, IN UINT MillisecondsPeriod );

NdisMSetPeriodicTimer 함수는 정기적으로 자극하기 위해서 타이머를 설정한다. 따라서 연관된 MiniportTimer 함수는 고정된 간격으로 반복적으로 실행된다.

매개변수

Timer

NdisMInitializeTimer 함수를 가지고 전에 초기화된 타이머 객체를 위한 호출자 제공 저장소를 가리킨다.

MillisecondsPeriod

타이머가 최소되지 않거나 이 간격이 리셋되지 않는다면 MiniportTimer 함수를 호출하기 전에 타임아웃을 위한 밀리초 단위의 간격을 서술한다.

주석

NdisMSetPeriodicTimer 함수는 MiniportInitialize 함수가 NdisMInitializeTimer 함수를 호출했을 때 타이머 객체와 연관된 드라이버 제공 MiniportTimer 함수로 하여금 주어진 MillisecondsPeriod가 만료될 때마다 반복적으로 실행되게 한다. MiniportTimer 함수가 실행되고 타이머 객체가 다음 간격동안에 자동적으로 다시 큐에 저장될 때 NdisMSetPeriodicTimer 함수로의 처음 호출에서 타이머 객체는 MillisecondsPeriod가 만료될 때까지 큐에 저장된다.

반대로 NdisMSetTimer 함수는 특정 타이머 객체와 연관된 드라이버 제공 함수로 하여금 주어진 MillisecondsToDelay가 만료된 후에 한번만 실행하도록한다. 즉 NdisMSetTimer 함수로 전달된 Timer와 연관된 함수의 실행은 주기적이기 보다는 일시적이다.

일반적인 규칙에 의해서 미니포트가 NdisMSetPeriodicTimer와 NdisMSetTimer 함수를 호출한다면 두 개의 타이머 객체를 할당하고 초기화 해야한다. 그러한 드라이버는 NdisMInitializeTimer 함수를 가지고 초기화됐을 때 각각의 특정 타이머 객체와 연관된 다른 기능을 가진 두 개의 MiniportTimer 함수를 가지고 있는 것과 같다. 예를들어 NIC에서 타임아웃된다면 또다른 MiniportTimer 함수가 특정 런타임 연산을 다시 시도하는 동안에 주기적으로 실행되는 MiniportTimer 함수는 규칙적인 간격으로 장치의 상태를 검사한다.

미니포트가 NdisMSetPeriodicTimer 함수로 전달된 같은 Timer 포인터를 가지고 NdisMSetPeriodicTimer, NdisMCancelTimer, 혹은 NdisMSetTimer 함수를 호출한다면 현재 호출은 원래 명시된 MillisecondsPeriod를 리셋하므로써 NdisMSetPeriodicTimer 함수로의 앞선 호출을 취소한다. NdisMSet..Timer 함수로의 어떤 호출은 가장 최근의 호출에서 명시된 간격에서 만료시키기 위해서 주어진 타이머를 리셋한다. 그리고 연관된 MiniportTimer 함수로 하여금 가장 최근에 명시된 간격이 만료될 때 실행하도록한다.

호스트에서 Timer 해결은 다양하다. 결국 매우 작은 기간을 가진 NdisMSetPeriodicTimer 함수를 호출하는 것은 명시된 간격이 만료될 때 MiniportTimer 함수의 실행을 반드시 야기하지는 않는다. 윈도우즈 2000 플랫폼에 서술된 최소의 실행 간격은 10 밀리초이다.

NdisMSetPeriodicTimer 함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 실행한다.