estrutura EXT_DELETE_PARAMETERS (wdm.h)

A estrutura EXT_DELETE_PARAMETERS contém um conjunto estendido de parâmetros para a rotina ExDeleteTimer .

Sintaxe

typedef struct _EXT_DELETE_PARAMETERS {
  ULONG                Version;
  ULONG                Reserved;
  PEXT_DELETE_CALLBACK DeleteCallback;
  PVOID                DeleteContext;
} EXT_DELETE_PARAMETERS, *PEXT_DELETE_PARAMETERS;

Membros

Version

O número de versão dessa estrutura EXT_DELETE_PARAMETERS . A rotina ExInitializeDeleteTimerParameters define esse membro como o número de versão correto.

Reserved

Defina como zero. A rotina ExInitializeDeleteTimerParameters define esse membro como zero.

DeleteCallback

Um ponteiro para uma rotina de retorno de chamada ExTimerDeleteCallback implementada pelo driver. O sistema operacional chama essa rotina quando o temporizador é excluído. Esse parâmetro é opcional e pode ser NULL se nenhuma rotina de retorno de chamada de exclusão de temporizador for necessária.

A rotina ExInitializeDeleteTimerParameters define esse membro como NULL. Para obter mais informações, consulte Comentários.

DeleteContext

Um valor de contexto para a rotina de retorno de chamada de exclusão de temporizador. O sistema operacional passa esse valor como um parâmetro para a rotina de retorno de chamada de exclusão de temporizador, se for especificado. Esse parâmetro normalmente é um ponteiro para uma estrutura definida pelo chamador que contém informações de contexto usadas pela rotina de retorno de chamada. Esse parâmetro é opcional e pode ser definido como NULL se nenhuma informação de contexto for necessária.

A rotina ExInitializeDeleteTimerParameters define esse membro como NULL.

Comentários

O parâmetro Parameters da rotina ExDeleteTimer é um ponteiro para uma estrutura EXT_DELETE_PARAMETERS . Antes de passar uma estrutura EXT_DELETE_PARAMETERS para essa rotina, chame a rotina ExInitializeDeleteTimerParameters para inicializar a estrutura.

Seu driver pode usar uma rotina de retorno de chamada ExTimerDeleteCallback para liberar qualquer armazenamento ou outros recursos do sistema que o driver possa ter alocado anteriormente para usar com o objeto de temporizador que está sendo excluído. Por exemplo, o valor de contexto do driver pode apontar para uma estrutura alocada pelo chamador que precisa ser liberada se o objeto do temporizador for excluído. O sistema operacional chama a rotina ExTimerDeleteCallback somente depois que o objeto de temporizador tiver sido desabilitado para evitar operações de temporizador adicionais e qualquer operação de temporizador pendente no objeto de temporizador for cancelada ou concluída.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte a partir de Windows 8.1.
Cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

Confira também

ExDeleteTimer

ExInitializeDeleteTimerParameters

ExTimerDeleteCallback