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

Статья
08/07/2023

Структура DEVICE_DSM_INPUT (или DEVICE_MANAGE_DATA_SET_ATTRIBUTES) указывает действие управления для атрибутов набора данных для устройства.

Синтаксис

typedef struct _DEVICE_MANAGE_DATA_SET_ATTRIBUTES {
  ULONG             Size;
  DEVICE_DSM_ACTION Action;
  ULONG             Flags;
  ULONG             ParameterBlockOffset;
  ULONG             ParameterBlockLength;
  ULONG             DataSetRangesOffset;
  ULONG             DataSetRangesLength;
} DEVICE_MANAGE_DATA_SET_ATTRIBUTES, *PDEVICE_MANAGE_DATA_SET_ATTRIBUTES, DEVICE_DSM_INPUT, *PDEVICE_DSM_INPUT;

Члены

Size

Размер структуры DEVICE_DSM_INPUT в байтах. Значение этого элемента изменится по мере добавления элементов в структуру.

Action

Значение DEVICE_DSM_ACTION, указывающее выполняемое действие. Список значений и описаний действий см. в разделе Описания DEVICE_DSM_ACTION.

Если флаг DeviceDsmActionFlag_NonDestructive (наиболее значительный бит) установлен в действии, указанное действие неразрушающее. Для неразрушительных действий драйвер может безопасно пересылать запрос IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES на следующий драйвер ниже в стеке, даже если драйвер не обрабатывает указанное действие. Если драйвер работает с DSM, он должен выполнить обычную обработку блока диапазонов набора данных, заданного элементами DataSetRangesOffset и DataSetRangesLength , прежде чем перенаправлять запрос IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES в следующий нижний драйвер.

Flags

Эти флаги являются глобальными для всех действий управления. Для этого элемента можно задать один из следующих флагов:

Значение флага	Значение
DEVICE_DSM_FLAG_ENTIRE_DATA_SET_RANGE	Действие элемента управления указывается для всего блока диапазонов наборов данных. Если этот флаг установлен, элементы DataSetRangesOffset и DataSetRangesLength должны иметь нулевое значение.

ParameterBlockOffset

Указывает начало блока параметров в полезных данных запроса IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES . Формат блока параметров зависит от значения элемента Action . Дополнительные сведения о формате блока параметров см. в разделе описания DEVICE_DSM_ACTION. Примечание. Смещение блока параметров должно быть выровнено по границе адреса соответствующего параметра.

Если параметр ParameterBlockOffset равен нулю, блок параметров не существует.

ParameterBlockLength

Указывает длину (в байтах) блока параметров в полезных данных запроса IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES.

Если параметр ParameterBlockLength имеет нулевое значение, блок параметров не существует.

DataSetRangesOffset

Указывает начало блока диапазонов набора данных в полезных данных запроса IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES. Этот блок состоит из одной или нескольких смежных записей, отформатированных как DEVICE_DSM_RANGE структуры. Примечание. Смещение блока диапазона набора данных должно быть выровнено по границе адреса структуры DEVICE_DSM_RANGE.

Если задано нулевое значение, блок диапазонов набора данных не существует.

DataSetRangesLength

Указывает длину (в байтах) блока диапазонов наборов данных в полезных данных запроса IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES. Если dataSetRangesLength имеет нулевое значение, блок диапазонов наборов данных не существует.

Дополнительные сведения о формате полезных данных для запроса IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES см. в разделе Общие сведения об управлении наборами данных. Общий размер буфера должен быть не менее sizeof(DEVICE_DSM_INPUT) + ParameterBlockLength + DataSetRangesLength.

Блок диапазонов наборов данных определяется элементами DataSetRangesOffset и DataSetRangesLength . Если этот блок существует, он содержит непрерывные DEVICE_DSM_RANGE структуры.