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
Definido como zero. A rotina ExInitializeDeleteTimerParameters define esse membro como zero.
DeleteCallback
Um ponteiro para um exTimerDeleteCallback implementado pelo driver rotina de retorno de chamada. 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.
Observações
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 o ExInitializeDeleteTimerParameters rotina para inicializar a estrutura.
O driver pode usar um ExTimerDeleteCallback rotina de retorno de chamada para liberar qualquer armazenamento ou outros recursos do sistema que o driver possa ter alocado anteriormente para usar com o objeto timer que está sendo excluído. Por exemplo, o valor de contexto do driver pode apontar para uma estrutura alocada por chamador que precisa ser liberada se o objeto do temporizador deve ser excluído. O sistema operacional chama a rotina exTimerDeleteCallback somente depois que o objeto de temporizador tiver sido desabilitado para impedir operações de temporizador adicionais e qualquer operação de temporizador pendente no objeto de temporizador for cancelada ou concluída.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Com suporte a partir do Windows 8.1. |
| cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |