NdisInitializeTimer

VOID NdisInitializeTimer( IN OUT PNDIS_TIMER Timer, IN PNDIS_TIMER_FUNCTION TimerFunction, IN PVOID FunctionContext );

NdisInitializeTimer함수는 드라이버의 타이머 함수와 관계된 타이버 오브젝트를 초기화 한다.

매개변수

Timer

호출자 제공 포인터, 타이머 오브젝트를 받을 상주 저장공간.

TimerFunction

타이머가 만료됐을때 호출되어지는 호출자 제공 타이머함수의 엔트리 포인트를 지정한다. 다음은 이 타이머함수의 구문을 설명한다.:

VOID 

  (*PNDIS_TIMER_FUNCTION)(

    IN PVOID  SystemSpecific1,

    IN PVOID  FunctionContext,

    IN PVOID  SystemSpecific2,

    IN PVOID  SystemSpecific3

    );

FunctionContext

호출되었을때 지정된 타이머 함수에게 넘겨지는 호출자 제공 컨텍스트의 포인터.

주석

프로토콜 드라이버는 NDIS가 타이밍 서비스들을 제공할것을 요구한다. 타이밍 서비스들을 요청하기위해, 이 프로토콜드라이버는 드라이버의 타이머 함수를 설정하기위해 NdisInitializeTimer함수를 호출한다. 일반적으로, NdisInitializeTimer함수는 드라이버가 초기화 할때 호출된다. 프로토콜 드라이버는 타이머 오브젝트를 저장하기위한 호출자 제공 포인터로 NdisInitializeTimer함수를 호출해야만 한다. 그때문에 드라이버 제공 타이머 함수는 타이머 오브젝트와 연관된다. 프로토콜 드라이버는 드라이버가 어떤 다른 Ndis..Timer함수에게 Timer포인터를 넘기기전에 NdisInitializeTimer함수를 호출해야만 한다.

NdisSetTimer함수의 호출은 타이머 오브젝트를 시스템 타이머 큐에 넣는다. NdisCancelTimer함수의 만약 현제 큐되었다면 호출은 타이머 오브젝트를 DE큐한다. 단지 하나의 특별한 타이머 오브젝트의 인스턴스만이 어떤 주어진 순간에 큐되어질수 있다.

드라이버가 NdisSetTimer함수를 호출한후, 그 콜내에 지정된 인터벌이 만료될때까지 Timer에 타이머 오브젝트는 큐된다. 인터벌이 만료된후, 타이머 오브젝트는 de큐되고 호출자 제공 TimerFunction은 프로세서가 이용할수 있게되자마자 IRQL DISPATCH_LEVEL에서 한번 동작한다.

NdisInitializeTimer함수의 호출자는 IRQL PASSIVE_LEVEL에서 동작한다.