структура EXT_DELETE_PARAMETERS (wdm.h)

  • Статья

Структура EXT_DELETE_PARAMETERS содержит расширенный набор параметров для подпрограммы ExDeleteTimer .

Синтаксис

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

Члены

Version

Номер версии этого EXT_DELETE_PARAMETERS структуры. Подпрограмма ExInitializeDeleteTimerParameters задает для этого элемента правильный номер версии.

Reserved

Задайте нулевое значение. Подпрограмма ExInitializeDeleteTimerParameters устанавливает для этого элемента значение 0.

DeleteCallback

Указатель на процедуру обратного вызова ExTimerDeleteCallback , реализованную драйвером. Операционная система вызывает эту подпрограмму при удалении таймера. Этот параметр является необязательным и может иметь значение NULL , если не требуется подпрограмма обратного вызова для удаления таймера.

Подпрограмма ExInitializeDeleteTimerParameters присваивает этому члену значение NULL. Дополнительные сведения см. в подразделе "Примечания".

DeleteContext

Значение контекста для подпрограммы обратного вызова по таймеру удаления. Операционная система передает это значение в качестве параметра в подпрограмму обратного вызова по таймеру удаления, если оно указано. Этот параметр обычно является указателем на структуру, определяемую вызывающим объектом, которая содержит сведения о контексте, используемые подпрограммой обратного вызова. Этот параметр является необязательным и может иметь значение NULL , если сведения о контексте не требуются.

Подпрограмма ExInitializeDeleteTimerParameters присваивает этому члену значение NULL.

Комментарии

Параметр Parameters подпрограммы ExDeleteTimer является указателем на структуру EXT_DELETE_PARAMETERS . Перед передачей структуры EXT_DELETE_PARAMETERS в эту подпрограмму вызовите подпрограмму ExInitializeDeleteTimerParameters , чтобы инициализировать структуру.

Драйвер может использовать подпрограмму обратного вызова ExTimerDeleteCallback , чтобы освободить хранилище или другие системные ресурсы, которые драйвер мог ранее выделить для использования с удаляемым объектом таймера. Например, значение контекста драйвера может указывать на структуру, выделенную вызывающим объектом, которую необходимо освободить, если объект таймера требуется удалить. Операционная система вызывает подпрограмму ExTimerDeleteCallback только после отключения объекта таймера, чтобы предотвратить дальнейшие операции таймера, а все ожидающие операции таймера с объектом таймера отменяются или завершаются.

Требования

Требование Значение
Минимальная версия клиента Поддерживается начиная с Windows 8.1.
Верхняя часть wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)

См. также раздел

ExDeleteTimer

ExInitializeDeleteTimerParameters

ExTimerDeleteCallback