estructura DEVICE_DSM_DEFINITION (ntddstor.h)

Artículo
08/07/2023

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_Xxx valor 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 de IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES .

ParameterBlockLength

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

HasOutput

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

OutputBlockAlignment

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

OutputBlockLength

Especifica la longitud, en bytes, del bloque de salida dentro de la carga de la solicitud de 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.

Comentarios

Cada acción DSM tiene una definición asociada a ella. Por ejemplo, DeviceDsmAction_Trim tiene DeviceDsmDefinition_Trim como definición asociada. El remitente o controlador dsm asigna e inicializa la estructura de 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 la necesitan.

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