structure DEVICE_DSM_DEFINITION (ntddstor.h)

Article
02/07/2025

La structure DEVICE_DSM_DEFINITION contient les propriétés d’une action de gestion de jeu de données (DSM).

Syntaxe

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;

Membres

Action

DeviceDsmDefinition_valeur de Xxx qui spécifie l’action à effectuer. Consultez DEVICE_DSM_ACTION Descriptions pour obtenir une liste de valeurs d’action et leurs valeurs de définition associées. Ces valeurs sont définies dans ntddstor.h.

SingleRange

Spécifie si l’action DSM ne prend en charge qu’une seule plage à la fois. Si l’action DSM doit être effectuée sur l’ensemble de la plage de jeu de données, l’indicateur DEVICE_DSM_FLAG_ENTIRE_DATA_SET_RANGE est défini.

ParameterBlockAlignment

Alignement du bloc de paramètres dans la charge utile de la requête IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES.

ParameterBlockLength

Longueur, en octets, du bloc de paramètres dans la charge utile de la requête IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES. Le bloc de paramètres suit la structure DSM_DEVICE_INPUT. Si ParameterBlockLength a la valeur zéro, le bloc de paramètres n’existe pas.

HasOutput

Définissez TRUE si l’action spécifiée dans la Action membre retourne la sortie ; sinon, définissez cette valeur sur FALSE.

OutputBlockAlignment

Alignement du bloc de sortie dans la charge utile de la requête IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES.

OutputBlockLength

Spécifie la longueur, en octets, du bloc de sortie dans la charge utile de la requête IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES. Le bloc de sortie suit la structure DSM_DEVICE_OUTPUT. Si OutputBlockLength a la valeur zéro, le bloc de sortie n’existe pas.

Remarques

Chaque action DSM a une définition associée. Par exemple, DeviceDsmAction_Trim a DeviceDsmDefinition_Trim comme définition associée. L’expéditeur ou le gestionnaire DSM alloue et initialise la structure DEVICE_DSM_DEFINITION avec la définition appropriée. Ils passent ensuite le pointeur à cette structure à toutes les fonctions liées à DSM qui en ont besoin.

Consultez Vue d’ensemble de la gestion des ensembles de données pour plus d’informations sur le traitement d’un DSM.