NdisMCancelTimer

9/8/2008

Essa função cancela uma acima chamar para o NdisMSetPeriodicTimer função ou cancela a acima chamar para o NdisMSetTimer função se o intervalo especificado para NdisMSetTimer Não ainda expirou.

Syntax

            VOID NdisMCancelTimer(
            PNDIS_MINIPORT_TIMER 
            Timer
            ,
            PBOOLEAN 
            TimerCanceled
            );
        

Parameters

• Timer
  [no] Ponteiro para um objeto timer, já inicializado com o NdisMInitializeTimer função e um conjunto com o NdisMSetPeriodicTimer ou o NdisMSetTimer função.

• TimerCanceled
  [out] Ponteiro para uma variável Caller-supplied, que define essa função para TRUE se era o timer enfileirado e, em seguida, cancelada ou ao FALSE se o timer seja não foi definido ou tem já acionado.

Return Value

Nenhum.

Remarks

Todas as funções timer Network Driver Interface Specification (NDIS) operam em uma opacidade objeto timer, para que um driver NIC deve fornecer armazenamento residente. O MiniportInitialize função deve chamar NdisMInitializeTimer Com um ponteiro Caller-supplied para este armazenamento, assim, associando um driver fornecido MiniportTimer função com o objeto timer. MiniportInitialize deve chamar NdisMInitializeTimer Antes de driver passa os Timer ponteiro para qualquer outra função timer NDIS.

Se o NIC não geram interrupções, o driver NIC tem uma pesquisa MiniportTimer função ao monitor de NIC estado para de entrada recebe e para enviar conclusões.

Chamadas para o NdisMSetXXXTimer funções inserir o objeto timer na fila de timer de sistema. Chamadas para esta função desenfileirá o objeto timer se ele estiver atualmente enfileirado. Apenas uma instanciação de um objeto específico timer pode ser enfileirado a qualquer momento.

Um chamar para esta função enquanto o objeto timer designado por Timer é enfileirado Remove o objeto timer de fila, cancelando assim a execução de associado MiniportTimer função.

Um chamar subseqüente para NdisMSetTimer Ou NdisMSetPeriodicTimer Re-Queues o objeto timer para que o MiniportTimer função executa novamente quando expira o intervalo especificado.

Um chamar para esta função pode ocorrer apenas após um timer foi acionado mas antes de associado MiniportTimer função é executar. Geralmente, MiniportTimer Define um variável de estado imediatamente na entrada para indicar que ela é execução. Quando outra função da miniporta chama essa função, ele pode verificar esse um TimerCancelled variável no retorno deste chamar para determinar se seu chamar para essa função também cancelada a execução de MiniportTimer.

Um chamar para esta função enquanto MiniportTimer é execução não tem nenhum efeito na execução de MiniportTimer. Ele continua a executar até que ele retorne controle.

Requirements

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

See Also

Reference

MiniportInitialize
MiniportTimer
NdisMInitializeTimer
NdisMSetPeriodicTimer
NdisMSetTimer