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) |