estructura DEVICE_DSM_DEFINITION (ntddstor.h)

Artículo
02/07/2025

La estructura DEVICE_DSM_DEFINITION contiene las propiedades de una acción de administración de conjuntos de datos (DSM).

Sintaxis

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;

Miembros

Action

DeviceDsmDefinition_valor xxx que especifica la acción que se va a realizar. Consulte DEVICE_DSM_ACTION Descripciones para obtener una lista de valores de acción y sus valores de definición asociados. Estos valores se definen en ntddstor.h.

SingleRange

Especifica si la acción DSM solo admite un único intervalo a la vez. Si la acción DSM se va a realizar en todo el intervalo de conjuntos de datos, se establece la marca DEVICE_DSM_FLAG_ENTIRE_DATA_SET_RANGE.

ParameterBlockAlignment

Alineación del bloque de parámetros dentro de la carga de la solicitud IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES.

ParameterBlockLength

Longitud, en bytes, del bloque de parámetros dentro de la carga de la solicitud IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES. El bloque de parámetros seguirá la estructura DSM_DEVICE_INPUT. Si parameterBlockLength está establecido en cero, el bloque de parámetros no existe.

HasOutput

Establezca TRUE si la acción especificada en la acción miembro devolverá la salida; De lo contrario, establézcalo en FALSE.

OutputBlockAlignment

Alineación del bloque de salida dentro de la carga de la solicitud IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES.

OutputBlockLength

Especifica la longitud, en bytes, del bloque de salida dentro de la carga de la solicitud IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES. El bloque de salida sigue la estructura DSM_DEVICE_OUTPUT. Si OutputBlockLength se establece en cero, el bloque de salida no existe.

Observaciones

Cada acción DSM tiene una definición asociada. Por ejemplo, DeviceDsmAction_Trim tiene DeviceDsmDefinition_Trim como definición asociada. El remitente o controlador dsm asigna e inicializa la estructura DEVICE_DSM_DEFINITION con la definición adecuada. A continuación, pasan el puntero a esta estructura a todas las funciones relacionadas con DSM que lo necesitan.

Consulte Información general sobre la administración de conjuntos de datos para obtener información sobre cómo se procesa un DSM.