структура 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
Флаг, указывающий характеристики операции уведомления. Элемент флагов должен иметь одно из следующих значений:
| Флаг | Значение |
|---|---|
| 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, которые указывают тип файла для операции уведомления. В следующей таблице описаны значения 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 и ParameterBlockLeng th указывают расположение и размер блока параметров для операции уведомления. Блок параметров форматируется как структура DEVICE_DSM_NOTIFICATION_PARAMETERS.
- Если для элемента флагов задано значение нуля, DataSetRangesOffset и элементы DataSetRangesLength указывают блок диапазона набора данных в полезных данных IOCTL.
- Если для элемента флагов задано значение DEVICE_DSM_FLAG_ENTIRE_DATA_SET_RANGE, то DataSetRangesOffset и элементы DataSetRangesLeng th равны нулю, а действие уведомления включает весь диапазон набора данных для указанных файлов.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 7 |
| минимальный поддерживаемый сервер | Windows Server 2008 R2 |
| заголовка | ntddstor.h (include Ntddstor.h) |