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 deve 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 Wait como TRUE, Cancel também deverá ser TRUE; caso contrário, ocorrerá um bug marcar.

[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 TRUE, a rotina aguarda o temporizador expirar. Se FALSE, a rotina não aguarda. Para obter mais informações, consulte Comentários.

[in] Parameters

Um ponteiro para uma estrutura EXT_DELETE_PARAMETERS . O driver de chamada anteriormente chamou a rotina ExInitializeDeleteTimerParameters para inicializar essa estrutura.

Retornar valor

Essa rotina retornará TRUE se Cancel for TRUE e o temporizador for cancelado. Caso contrário, a rotina retornará FALSE. Para obter mais informações, consulte Comentários.

Comentários

Depois que o driver chama essa rotina, o objeto de temporizador apontado pelo Timer pode não ser mais válido. No entanto, o valor do parâmetro Timer passado para uma rotina de retorno de chamada ExTimerCallback , se o driver implementar essa rotina, será sempre um ponteiro válido para um objeto de temporizador.

Se Cancel 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 pode bloquear se Wait for TRUE. Se ExDeleteTimer for chamado da rotina ExTimerCallback do driver, que é chamada em DISPATCH_LEVEL, o parâmetro Wait nessa chamada deverá ser FALSE.

Se Wait for TRUE, a rotina deverá ser chamada em IRQL <= APC_LEVEL. Se Wait for FALSE, a rotina poderá ser chamada em IRQL <= DISPATCH_LEVEL.

Para obter mais informações, consulte Excluindo um objeto timer System-Allocated.

Requisitos

Confira também

EXT_DELETE_PARAMETERS

EX_TIMER

ExAllocateTimer

ExInitializeDeleteTimerParameters

ExTimerCallback

ExTimerDeleteCallback