NdisMSetTimer

VOID NdisMSetTimer( IN PNDIS_MINIPORT_TIMER Timer, IN UINT MillisecondsToDelay );

NdisMSetTimer 함수는 명시된 간격 후에 동작하는 타이머를 설정한다. 따라서 타이머가 동작할 때 연관된 MiniportTimer 함수가 실행된다.

매개변수

Timer

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

MillisecondsToDelay

MiniportTimer 함수를 호출하기 전에 타임아웃되는 단위가 밀리초인 간격을 서술한다.

주석

NdisMSetTimer 함수는 MiniportInitialize 함수가 NdisMInitializeTimer 함수를 호출했을 때 타이머 객체와 연관된 드라이버 제공 MiniportTimer 함수로 하여금 주어진 MillisecondsToDelay가 만료된 후에 한번 실행되도록한다. NdisMSetTimer 함수로 전달된 타이머와 연관된 MiniportTimer 함수의 실행은 주기적이기 보다는 일시적이다. 미니포트는 연관된 타이머 함수가 실행되어야할 때 NdisMSetTimer 함수를 호출한다.

반면에 NdisMSetPeriodicTimer 함수는 주어진 MillisecondsPeriod가 만료될 때마다 연관된 MiniportTimer 함수를 반복적으로 실행하도록한다. NdisMSetPeriodicTimer 함수로의 초기의 호출에서 MiniportTimer 함수가 실행되고 타이머 객체가 다음 간격을 위해서 자동적으로 다시 큐에 저장될 때 타이머 객체는 MillisecondsPeriod가 만료될 때까지 큐에 저장된다.

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

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

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

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