structure DEVICE_DSM_DEFINITION (ntddstor.h)

Article
02/26/2024

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_ ValeurXxx qui spécifie l’action à effectuer. Consultez descriptions DEVICE_DSM_ACTION pour obtenir la liste des valeurs d’action et les 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 du 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 demande 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 le membre Action 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 est défini sur zéro, le bloc de sortie n’existe pas.

Remarques

Une définition est associée à chaque action DSM. 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 vers cette structure vers toutes les fonctions liées à DSM qui en ont besoin.

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