DEVICE_MANAGE_DATA_SET_ATTRIBUTES structure (winioctl.h)

Structure d’entrée pour le code de contrôle IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES .

Syntaxe

typedef struct _DEVICE_MANAGE_DATA_SET_ATTRIBUTES {
  DWORD             Size;
  DEVICE_DSM_ACTION Action;
  DWORD             Flags;
  DWORD             ParameterBlockOffset;
  DWORD             ParameterBlockLength;
  DWORD             DataSetRangesOffset;
  DWORD             DataSetRangesLength;
} DEVICE_MANAGE_DATA_SET_ATTRIBUTES, *PDEVICE_MANAGE_DATA_SET_ATTRIBUTES, DEVICE_DSM_INPUT, *PDEVICE_DSM_INPUT;

Membres

Size

Taille de cette structure de données. Cette propriété doit être définie sur sizeof(DEVICE_MANAGE_DATA_SET_ATTRIBUTES).

Action

Valeur valide de type DEVICE_DATA_MANAGEMENT_SET_ACTION.

Valeur	Signification
DeviceDsmAction_Trim 1	Une action de découpage est effectuée. Cette valeur n’est pas prise en charge pour les applications en mode utilisateur.
DeviceDsmAction_Notification 2 | DeviceDsmActionFlag_NonDestructive (0x80000002)	Une action de notification est effectuée. Les paramètres supplémentaires se trouvent dans une structure DEVICE_DSM_NOTIFICATION_PARAMETERS . Le DeviceDsmActionFlag_NonDestructive (0x80000000) est un indicateur de bits pour indiquer à la pile des pilotes que cette opération est non destructive.
DeviceDsmAction_OffloadRead 3 | DeviceDsmActionFlag_NonDestructive (0x80000003)	Une action de lecture de déchargement est effectuée. Les paramètres supplémentaires se trouvent dans une structure DEVICE_DSM_OFFLOAD_READ_PARAMETERS . Le DeviceDsmActionFlag_NonDestructive (0x80000000) est un indicateur de bits pour indiquer à la pile des pilotes que cette opération est non destructive. Windows 7 et Windows Server 2008 R2 : Cette valeur n’est pas prise en charge avant Windows 8 et Windows Server 2012.
DeviceDsmAction_OffloadWrite 4	Une action d’écriture de déchargement est effectuée. Les paramètres supplémentaires se trouvent dans une structure DEVICE_DSM_OFFLOAD_WRITE_PARAMETERS . Windows 7 et Windows Server 2008 R2 : Cette valeur n’est pas prise en charge avant Windows 8 et Windows Server 2012.
DeviceDsmAction_Allocation 5 | DeviceDsmActionFlag_NonDestructive (0x80000005)	Une bitmap d’allocation est récupérée pour la première plage de jeu de données spécifiée. Le DeviceDsmActionFlag_NonDestructive (0x80000000) est un indicateur de bits pour indiquer à la pile des pilotes que cette opération est non destructive. Windows 7 et Windows Server 2008 R2 : Cette valeur n’est pas prise en charge avant Windows 8 et Windows Server 2012.
DeviceDsmAction_Repair 6 | DeviceDsmActionFlag_NonDestructive (0x80000006)	Une action de réparation est effectuée. Les paramètres supplémentaires se trouvent dans une structure DEVICE_DATA_SET_REPAIR_PARAMETERS . Le DeviceDsmActionFlag_NonDestructive (0x80000000) est un indicateur de bits pour indiquer à la pile des pilotes que cette opération est non destructive. Windows 7 et Windows Server 2008 R2 : Cette valeur n’est pas prise en charge avant Windows 8 et Windows Server 2012.
DeviceDsmAction_Scrub 7 | DeviceDsmActionFlag_NonDestructive (0x80000007)	Une action de nettoyage est effectuée. Le DeviceDsmActionFlag_NonDestructive (0x80000000) est un indicateur de bits pour indiquer à la pile des pilotes que cette opération est non destructive. Windows 7 et Windows Server 2008 R2 : Cette valeur n’est pas prise en charge avant Windows 8 et Windows Server 2012.
DeviceDsmAction_Resiliency 8 | DeviceDsmActionFlag_NonDestructive (0x80000008)	Une action de résilience est effectuée. Le DeviceDsmActionFlag_NonDestructive (0x80000000) est un indicateur de bits pour indiquer à la pile des pilotes que cette opération est non destructive. Windows 7 et Windows Server 2008 R2 : Cette valeur n’est pas prise en charge avant Windows 8 et Windows Server 2012.

Flags

Indicateurs pour les actions.

Valeur	Signification
DEVICE_DSM_FLAG_TRIM_NOT_FS_ALLOCATED 0x80000000	Si elles sont définies, les plages décrites ne sont pas allouées par un système de fichiers. Cet indicateur est spécifique à l’action DeviceDsmAction_Trim .
DEVICE_DSM_FLAG_RESILIENCY_START_RESYNC 0x10000000	Démarre une opération de resynchronisation sur le périphérique de stockage. Cet indicateur est spécifique à l’action DeviceDsmAction_Resiliency .
DEVICE_DSM_FLAG_RESILIENCY_START_LOAD_BALANCING 0x20000000	Démarre une opération d’équilibrage de charge sur le périphérique de stockage. Cet indicateur est spécifique à l’action DeviceDsmAction_Resiliency .

ParameterBlockOffset

Décalage d’octets vers le début du bloc de paramètres stocké dans la mémoire tampon contiguë à cette structure. Doit être aligné sur l’alignement de structure correspondant. La valeur zéro indique qu’il n’existe aucun bloc de paramètres et que le membre ParameterBlockLength doit également être égal à zéro.

ParameterBlockLength

Longueur du bloc de paramètres, en octets. La valeur zéro indique qu’il n’existe aucun bloc de paramètres et que le membre ParameterBlockOffset doit également être égal à zéro.

DataSetRangesOffset

Décalage d’octets vers le début du bloc de plages de jeu de données constitué d’un tableau de structures DEVICE_DATA_SET_RANGE stockées dans la mémoire tampon contiguë à cette structure. Doit être aligné sur l’alignement de structure DEVICE_DATA_SET_RANGE . La valeur zéro indique qu’il n’existe aucun bloc de plages de jeux de données et que le membre DataSetRangesLength doit également être égal à zéro.

DataSetRangesLength

Longueur du bloc de plages de jeu de données, en octets. La valeur zéro indique qu’il n’existe aucun bloc de plages de jeux de données et que le membre DataSetRangesOffset doit également être égal à zéro.

Remarques

La longueur totale de la mémoire tampon qui contient cette structure doit être au moins (sizeof(DEVICE_MANAGE_DATA_SET_ATTRIBUTES) + ParameterBlockLength + DataSetRangesLength).

Configuration requise

Client minimal pris en charge	Windows 7
Serveur minimal pris en charge	Windows Server 2008 R2
En-tête	winioctl.h (inclure Windows.h)

Voir aussi

DEVICE_DATA_SET_RANGE

structures Gestion des appareils

IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES