NdisMSetTimer

9/8/2008

Essa função define um timer para acionar após um intervalo especificado, assim, execução um associado MiniportTimer função quando o timer for acionado.

Syntax

VOID NdisMSetTimer(
  PNDIS_MINIPORT_TIMER Timer,
  UINT MillisecondsToDelay
);

Parameters

• Timer
  [no] Ponteiro para armazenamento residente Caller-supplied para um objeto timer anteriormente inicializado com o NdisMInitializeTimer função.

• MillisecondsToDelay
  [no] Especifica o intervalo, em milissegundos, para tempo limite antes chamado de MiniportTimer função.

Return Value

Nenhum.

Remarks

Essa função faz com que o driver fornecido MiniportTimer função, que estava associado com o objeto timer quando MiniportInitialize chamado NdisMInitializeTimer, para executar uma vez após a determinado MillisecondsToDelay expirar. A execução das MiniportTimer função associado com o Timer passado para essa função é episodic, em vez periódicos. Uma miniporta deve chamar esta função cada tempo o associado função timer deve ser executar.

Por contraste, o NdisMSetPeriodicTimer função faz com que o associado MiniportTimer função seja executar repetidamente sempre especificado MillisecondsPeriod expirar. Na chamar inicial para NdisMSetPeriodicTimer, o objeto timer é enfileirado até a MillisecondsPeriod Expira; Depois de MiniportTimer função é executar e o timer objeto é automaticamente re-Queued para o próximo intervalo.

Geralmente, uma miniporta deve alocar e separar dois inicializar timer objetos se ele chama ambos NdisMSetPeriodicTimer e essa função. Tal um driver é provável que tenha duas MiniportTimer funções com funcionalidade diferente, cada associado com um objeto específico timer quando ele é inicializado com NdisMInitializeTimer. De exemplo, um MiniportTimer função executada periodicamente pode pesquisar estado dispositivo no regular intervalos, enquanto outro MiniportTimer função pode repetir uma executar determinada-operação tempo somente se ela expirar no NIC.

Se uma miniporta chama essa função, NdisMCancelTimer, ou NdisMSetPeriodicTimer com o mesmo Timer ponteiro originalmente passados para essa função antes de originalmente especificado MillisecondsToDelay expirar, o atual chamar cancela sua acima chamar para essa função. Qualquer chamar para uma função timer NDIS redefine o timer especificado para expirar no intervalo especificado na chamar mais recente e faz com que o associado MiniportTimer função para executar quando o intervalo especificado mais recentemente tiver expirado.

Resolução do timer na hospedar varia. Conseqüentemente, chamado essa função com valores tempo limite muito pequena faz não necessariamente causar a execução de MiniportTimer exatamente quando o intervalo especificado expira.

Requirements

Header	ndis.h
Library	ndis.dll
Windows Embedded CE	Windows CE .NET 4.0 and later

See Also

Reference

NdisMInitializeTimer
MiniportInitialize
MiniportTimer
NdisMSetPeriodicTimer
NdisMCancelTimer