MiniportTimer
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
MiniportTimer é um exigido função se um driver do NIC não geram interrupções. Caso contrário, um ou mais MiniportTimer funções são opcional.
Syntax
VOID MiniportTimer(
PVOID SystemSpecific1,
PVOID FunctionContext,
PVOID SystemSpecific2,
PVOID SystemSpecific3
);
Parameters
- SystemSpecific1
[no] Aponta para uma variável SYSTEM-specific, que é opacidade para MiniportTimer e reservado para uso sistema.
- FunctionContext
[no] Especifica o ponteiro contexto passado para NdisMInitializeTimer Quando MiniportInitialize Configurar o associado objeto timer.
- SystemSpecific2
[no] Aponta para um valor System-specific que é reservado para uso sistema.
- SystemSpecific3
[no] Aponta para um valor System-specific que é reservado para uso sistema.
Remarks
O driver de uma NIC que não gera interrupções deve ter um MiniportTimer função para pesquisar o estado do NIC. Após tal de um driver MiniportInitialize função configura o objeto driver-allocated timer com NdisMInitializeTimer, um chamar para NdisMSetPeriodicTimer Faz com que o MiniportTimer função associado com o objeto timer seja executar repetidamente e automaticamente no intervalo especificado pelo MillisecondsPeriod. Tal uma pesquisa MiniportTimer função monitora o estado do NIC para determinar quando fazer indicações, quando a completo pendente envia, e assim por diante. No efeito, de tal uma pesquisa MiniportTimer função tem a mesma funcionalidade como o MiniportHandleInterrupt função no driver de uma NIC que geram interrupções.
Por contraste, chamado NdisMSetTimer Faz com que o MiniportTimer função associado com o objeto timer seja executar uma vez quando o determinado MillisecondsToDelay expirar. Tais um MiniportTimer função geralmente executa alguma ação driver-determined se uma determinada operação expira.
Se o tipo de MiniportTimer função compartilha recursos com outras funções driver, o driver deve sincronizar acessar esses recursos com um bloqueio de rotação.
Qualquer driver NIC ou intermediário driver pode ter mais de um MiniportTimer função de vontade de gravador de driver. Cada como MiniportTimer função deve ser associado com um objeto driver-allocated e inicializado timer.
Um chamar para NdisMCancelTimer Cancela a execução de não-pesquisa MiniportTimer função, se o intervalo passado no imediatamente acima chamar para NdisMSetTimer Não ainda expirou. Após um chamar para NdisMSetPeriodicTimer, um chamar para NdisMSetTimer Ou NdisMCancelTimer com o mesmo timer objeto desabilita uma pesquisa MiniportTimer função: ou a função MiniportTimer é executado uma vez, ou ele é cancelado.
O MiniportHalt função de qualquer driver com um MiniportTimer função deve chamar NdisMCancelTimer Para garantir que o MiniportTimer função não tenta acessar recursos que MiniportHalt já foi lançado.
Requirements
| Header | externs.h |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
See Also
Reference
MiniportHalt
MiniportInitialize
NdisAcquireSpinLock
NdisAllocateSpinLock
NdisDprAcquireSpinLock
NdisMCancelTimer
NdisMInitializeTimer
NdisMSetPeriodicTimer
NdisMSetTimer