NdisMCancelTimer

VOID NdisMCancelTimer( IN PNDIS_MINIPORT_TIMER Timer, OUT PBOOLEAN TimerCancelled );

만약 NdisMSetTimer함수에게 주어진 인터벌이 아직 만료되지 않았다면 NdisMCancelTimer함수는 NdisMSetPeriodicTimer함수의 선행 호출을 취소하거나 선행하는 NdisMSetTimer함수의 호출을 취소한다.

매개변수

Timer

타이머 객체의 포인터, NdisMInitializeTimer함수로 이미 초기화되고 NdisMSetPeriodicTimer혹은 NdisMSetTimer함수로 설정하는 포인터.

TimerCancelled

만약 타이머는 큐화되고나서 취소된다면, TRUE를 설정하고 만약 타이버가 설정되지 않거나 이미 만료되지 않았다면 FALSE를 설정하는 호출자 제공 변수의 포인터.

주석

닉 드라이버가 상주 저장공간을 제공해야만 하는 것에대해 모든 NdisM..Timer함수는 모호한 타이머 객체에서 동작한다. MiniportInitialize함수는 이 저장공간에대한 호출자 제공 포인터로 NdisMInitializeTimer함수를 호출해야만 하므로 드라이버제공 MiniportTimer함수와 타이머 객체와 관계된다. MiniportInitialize함수는 드라이버가 Timer포인터를 어떤 다른 NdisM..Timer함수에게 넘기기전에 NdisMInitializeTimer함수를 호출해야만 한다.

인터럽트를 발생하지 않는 닉 드라이버들은 들어오는 수신과 보내기 완료에대한 닉의 상태를 모니터 하기위해 폴링 MiniportTimer함수를 가지고 있다.

NdisMSet..Timer함수들에대한 호출은 타이머 객체를 시스템 타이머 큐에 삽입한다. 만약 현재 큐 되었다면,NdisMCancelTimer 함수의 호출은 타이머 객체를 디큐한다. 특별한 타이머 객체에서 단 하나의 예시는 어떤 주어진 순간에 큐 될 수 있다.

Timer에의해 설명된 타이머 객체가 큐로부터 타이머 객체를 제거하는 동안 NdisMCancelTimer함수를 호출하므로, 연관된 MiniportTimer함수의 실행을 취소한다.

NdisMSetTimer 혹은 NdisMSetPeriodicTimer함수의 순차적인 호출은 주어진 인터벌이 만료될때 타이머 객체를 재큐해서 MiniportTimer함수를 다시 동작되게 할것이다.

NdisMCancelTimer함수의 호출은 타이머가 만료됐지만 연관된 MiniportTimer함수가 동작하기 바로전에 발생할수 있다. 일반적으로, MiniportTimer함수는 동작하고 있다는 것을 알리기위해 엔트리에 즉시 상태 변수를 설정한다. 또다른 미니포트 함수가 NdisMCancelTimer함수를 호출할때, 미니포트는 NdisMCancelTimer함수의 호출이 또한 MiniportTimer함수의 동작을 취소할수 있는지를 결정하기위한 이호출로부터의 리턴에 그런 TimerCancelled변수를 체크할수 있다.

MiniportTimer함수가 동작하고 있는동안 NdisMCancelTimer함수의 호출은 MiniportTimer함수의 실행에 아무런 영향을 끼치지 않는다. 컨추럴을 리턴할때까지 동작을 계속한다.

NdisMCancelTimer함수의 호출은 IRQL <= DISPATCH_LEVEL에서 동작한다.