NdisMSetPeriodicTimer

9/8/2008

Essa função define um timer para acionar periodicamente, assim, execução Caller-supplied um associadoMiniportTimer função repetidamente a intervalos fixos.

Syntax

VOID NdisMSetPeriodicTimer(
  PNDIS_MINIPORT_TIMER Timer,
  UINT MillisecondsPeriod
);

Parameters

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

• MillisecondsPeriod
  [no] Especifica o intervalo, em milissegundos, para tempo limite antes chamado de MiniportTimer função, a menos que o timer seja cancelado ou esse intervalo é redefinir.

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, seja executar repetidamente sempre especificado MillisecondsPeriod expirar. O chamar inicial para esta função, 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.

Por contraste, NdisMSetTimer Faz com que a função driver-supplied associado com um objeto específico timer para executar apenas uma vez após a determinado MillisecondsToDelay expirar. Isto é, execução desta função associado com o Timer passado para NdisMSetTimer é episodic, vez periódicos.

Como regra geral, uma miniporta deve alocar e separar dois inicializar timer objetos se ele chama dois essa função e NdisMSetTimer. 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 NdisMSetTimer com o mesmo Timer ponteiro originalmente passado para essa função, a atual chamar cancela sua acima chamar para esta função, possivelmente redefinindo o MillisecondsPeriod originalmente especificado. 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 períodos muito pequenos faz não necessariamente causar a execução das MiniportTimer função exatamente quando expira o intervalo especificado.

Requirements

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

See Also

Reference

MiniportTimer
NdisMInitializeTimer
MiniportInitialize
NdisMSetTimer
NdisMCancelTimer