NdisCancelTimer

VOID NdisCancelTimer( IN PNDIS_TIMER Timer, OUT PBOOLEAN TimerCanceled );

NdisCancelTimer함수는 만약 NdisSetTimer에게 주어진 인터벌이 아직 만료되지 않았다면 NdisSetTimer를 호출하는 처리를 즉각적으로 취소한다.

매개변수

Timer

타이머 오브젝트의 포인터, 이미 NdisInitializeTimer함수로 초기화되고 NdisSetTimer함수로 설정됐다.

TimerCanceled

호출자 제공 변수를 가리킨다. NdisCancelTimer함수는 만약 타이머가 저장되고 그리고나서 취소가 된다면 이 변수를 TRUE로 설정하고, 만약 타이머가 설정되어있지않거나 연관된 타이머 함수들을 동작하도록하거나 이미 만료됐다면 FALSE이다.

주석

프로토콜 드라이버가 존재하는저장공간을 제공해야 하는것에대해서 모든 Ndis..Timer함수들은 모호한 타이머 오브젝트에서 동작한다. 프로토콜 드라이버는 이저장 장소에 대한 호출자 제공 포인터를 가지고 NdisInitializeTimer함수를 호출한다. 따라서 타이머 오브젝트를 통해 드라이버 제공 타이머 함수를 연관짓는다. 프로토콜 드라이버는 드라이버가 어떤 다른 Ndis...Timer 함수에대한 Timer포인터를 넘겨주기전에 NdisInitializeTimer함수를 호출해야만한다.

다음은 드라이버제공 타이머 함수의 구문을 설명한다.:

VOID (*PNDIS_TIMER_FUNCTION)( IN PVOID SystemSpecific1, IN PVOID FunctionContext, IN PVOID SystemSpecific2, IN PVOID SystemSpecific3 );

NdisSetTimer함수의 호출자는 시스템 타이머 큐에 타이머 오브젝트를 삽입한다. 타이머 오브젝트가 저장되는 인터벌 동안, NdisCancelTimer함수의 호출은 큐로부터 타이버 오브젝트를 제거한다. 연관된 타이머 함수의 실행의 취소에의해. 특별한 타이머 오브젝의 유일한 인스턴스는 어떤 주어진 시간에 큐화되어질수 있다.

NdisSetTimer에대한 순차적인 호출은 타이머 오브젝트를 다시 큐화하고 타이머 함수는 다시 주어진 인터벌이 만료될때 동작될것이다.

만약 타이머가 큐화되고 그리고나서 취소되었다면, NdisCancelTimer함수의 호출은 TimerCanceled 파라미터내에 TRUE를 리턴한다. NdisCancelTimer함수는 만약 타이머 함수가 이미 동작하고 있거나 동작하는것으로부터 타이머 함수를 멈추는 방법이 없다면 FALSE를 리턴한다. 만약 NdisCancelTimer함수가 FALSE를 리턴하면, 호출자는 적절한 동작을 취해야만 한다.

NdisCancelTimer의 호출자는 IRQL <= DISPATCH_LEVEL에서 동작한다.