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

Статья
08/07/2023

Структура DEVICE_DSM_DEFINITION содержит свойства для действия управления набором данных (DSM).

Синтаксис

typedef struct _DEVICE_DSM_DEFINITION {
  DEVICE_DSM_ACTION Action;
  BOOLEAN           SingleRange;
  ULONG             ParameterBlockAlignment;
  ULONG             ParameterBlockLength;
  BOOLEAN           HasOutput;
  ULONG             OutputBlockAlignment;
  ULONG             OutputBlockLength;
} DEVICE_DSM_DEFINITION, *PDEVICE_DSM_DEFINITION;

Члены

Action

DeviceDsmDefinition_ значениеXxx , указывающее выполняемое действие. Список значений действий и связанных с ними значений определений см. в разделе Описания DEVICE_DSM_ACTION. Эти значения определены в ntddstor.h.

SingleRange

Указывает, поддерживает ли действие DSM только один диапазон одновременно. Если действие DSM должно выполняться для всего диапазона набора данных, устанавливается флаг DEVICE_DSM_FLAG_ENTIRE_DATA_SET_RANGE.

ParameterBlockAlignment

Выравнивание блока параметров в полезных данных запроса IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES .

ParameterBlockLength

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

HasOutput

Задайте значение TRUE, если действие, указанное в элементе Action , будет возвращать выходные данные; В противном случае задайте для этого параметра значение FALSE.

OutputBlockAlignment

Выравнивание выходного блока в полезных данных запроса IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES.

OutputBlockLength

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

С каждым действием DSM связано определение. Например, DeviceDsmAction_Trim имеет DeviceDsmDefinition_Trim в качестве связанного определения. Отправитель или обработчик DSM выделяет и инициализирует структуру DEVICE_DSM_DEFINITION с соответствующим определением. Затем они передают указатель на эту структуру всем функциям, связанным с DSM, которым она нужна.

Сведения о том, как обрабатывается DSM, см. в разделе Общие сведения об управлении набором данных.