Share via

структура DEVICE_DSM_NOTIFICATION_PARAMETERS (ntddstor.h)

  • Статья

Структура DEVICE_DSM_NOTIFICATION_PARAMETERS задает параметры для операции уведомления, связанной с атрибутами набора данных для устройства.

Синтаксис

typedef struct _DEVICE_DSM_NOTIFICATION_PARAMETERS {
  ULONG Size;
  ULONG Flags;
  ULONG NumFileTypeIDs;
  GUID  FileTypeID[ANYSIZE_ARRAY];
} DEVICE_DSM_NOTIFICATION_PARAMETERS, *PDEVICE_DSM_NOTIFICATION_PARAMETERS;

Члены

Size

Общий размер этой структуры в байтах. Значение этого элемента должно включать общий размер элемента FileTypeID в байтах.

Flags

Флаг , указывающий характеристики операции уведомления. Для элемента Flags необходимо задать одно из следующих значений:

Flag Значение
DEVICE_DSM_NOTIFY_FLAG_BEGIN Диапазон адресов логического блока (LBA) в настоящее время используется типами файлов, указанными в элементе FileTypeID . Диапазон LBA определяется диапазоном набора данных в полезных данных запроса IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES .
DEVICE_DSM_NOTIFY_FLAG_END Диапазон LBA больше не используется типами файлов, указанными в элементе FileTypeID .

NumFileTypeIDs

Количество записей в элементе FileTypeID .

FileTypeID[ANYSIZE_ARRAY]

Одно или несколько значений GUID , указывающих тип файла для операции уведомления. В следующей таблице описаны значения GUID FileTypeID .

Значение GUID Описание
FILE_TYPE_NOTIFICATION_GUID_PAGE_FILE Указывает операцию уведомления для файла подкачки.
FILE_TYPE_NOTIFICATION_GUID_HIBERNATION_FILE Указывает операцию уведомления для файла гибернации системы.
FILE_TYPE_NOTIFICATION_GUID_CRASHDUMP_FILE Указывает операцию уведомления для файла дампа сбоя системы.

Комментарии

Уведомление указывается в блоке параметров в полезных данных запроса IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES . Общее описание макета полезных данных см. в статье Общие сведения об управлении набором данных.

Начиная с Windows 7 файловая система NTFS уведомляет стек хранилища при изменении диапазона набора данных адресации логических блоков (LBA) для указанного набора файлов. Файловая система отправляет это уведомление, отправляя стеку хранилища запрос IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES с системным буфером, содержащим структуру DEVICE_DSM_INPUT . Для операции уведомления файловая система задает элементы структуры DEVICE_DSM_INPUT следующим образом:

  • Для элемента Action задано значение DeviceDsmAction_Notification.
  • Элементы ParameterBlockOffset и ParameterBlockLength указывают расположение и размер блока параметров для операции уведомления. Блок параметров имеет формат структуры DEVICE_DSM_NOTIFICATION_PARAMETERS.
  • Если элемент Flags имеет нулевое значение, элементы DataSetRangesOffset и DataSetRangesLength указывают блок диапазона набора данных в полезных данных IOCTL.
  • Если для элемента Flags задано значение DEVICE_DSM_FLAG_ENTIRE_DATA_SET_RANGE, элементы DataSetRangesOffset и DataSetRangesLength равны нулю, а действие уведомления включает весь диапазон набора данных для указанных файлов.

Требования

Требование Значение
Минимальная версия клиента Windows 7
Минимальная версия сервера Windows Server 2008 R2
Верхняя часть ntddstor.h (включая Ntddstor.h)

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

Общие сведения об управлении наборами данных

Описания DEVICE_DSM_ACTION

DEVICE_DSM_INPUT

IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES