Função ExDeleteTimer (wdm.h)
A rotina ExDeleteTimer exclui um objeto de temporizador que foi alocado anteriormente pela rotina exAllocateTimer.
Sintaxe
BOOLEAN ExDeleteTimer(
[in] PEX_TIMER Timer,
[in] BOOLEAN Cancel,
[in] BOOLEAN Wait,
[in] PEXT_DELETE_PARAMETERS Parameters
);
Parâmetros
[in] Timer
Um ponteiro para uma estrutura EX_TIMER. Essa estrutura é um objeto de temporizador que foi alocado anteriormente pela rotina ExAllocateTimer.
[in] Cancel
Se o temporizador será cancelado se ele estiver definido no momento. Se TRUE, a rotina cancelará o temporizador se o temporizador estiver definido. Se FALSE, a rotina não cancelará o temporizador se ele estiver definido. Se o chamador definir de Espera como TRUE, Cancelar também deverá ser VERDADEIRO; caso contrário, ocorrerá uma verificação de bug.
[in] Wait
Se o temporizador deve ser aguardado para concluir a expiração se o temporizador já tiver iniciado o processo de expiração. Se VERDADEIRO, a rotina aguardará o temporizador expirar. Se FALSE, a rotina não aguardará. Para obter mais informações, consulte Comentários.
[in] Parameters
Um ponteiro para uma estrutura EXT_DELETE_PARAMETERS. O driver de chamada anteriormente chamado ExInitializeDeleteTimerParameters rotina para inicializar essa estrutura.
Valor de retorno
Essa rotina retornará TRUE se Cancelar for TRUE e o temporizador tiver sido cancelado. Caso contrário, a rotina retornará FALSE . Para obter mais informações, consulte Comentários.
Observações
Depois que o driver chama essa rotina, o objeto de temporizador apontado por Timer pode não ser mais válido. No entanto, o valor do parâmetro Timer passado para um exTimerCallback rotina de retorno de chamada, se o driver implementar essa rotina, é sempre um ponteiro válido para um objeto de temporizador.
Se Cancelar for TRUE, um valor retornado de FALSE indicará que o temporizador nunca foi definido ou que o temporizador foi definido, mas expirou antes de ser cancelado. Se Cancelar for FALSE, a rotina sempre retornará FALSE .
Essa rotina poderá ser bloqueada se de Espera estiver verdadeiro. Se ExDeleteTimer for chamado da rotina de ExTimerCallback do driver, que é chamada em DISPATCH_LEVEL, o parâmetro Wait nesta chamada deverá ser FALSE.
Se wait for VERDADEIRO, a rotina deverá ser chamada em IRQL <= APC_LEVEL. Se de Espera for FALSE, a rotina poderá ser chamada em IRQL <= DISPATCH_LEVEL.
Para obter mais informações, consulte Excluindo um objeto System-Allocated timer.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows 8.1. |
| da Plataforma de Destino | Universal |
| cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca | Ntoskrnl.lib |
| IRQL | Consulte Comentários. |