DEVICE_DATA_SET_LB_PROVISIONING_STATE structure (ntddstor.h)

La structure DEVICE_DATA_SET_LB_PROVISIONING_STATE est retournée par une demande de IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES lors de la demande d’informations d’approvisionnement de blocs logiques pour une plage de jeu de données.

Syntaxe

typedef struct _DEVICE_DATA_SET_LB_PROVISIONING_STATE {
  ULONG     Size;
  ULONG     Version;
  ULONGLONG SlabSizeInBytes;
  ULONG     SlabOffsetDeltaInBytes;
  ULONG     SlabAllocationBitMapBitCount;
  ULONG     SlabAllocationBitMapLength;
  ULONG     SlabAllocationBitMap[ANYSIZE_ARRAY];
} DEVICE_DATA_SET_LB_PROVISIONING_STATE, *PDEVICE_DATA_SET_LB_PROVISIONING_STATE, DEVICE_DSM_ALLOCATION_OUTPUT, *PDEVICE_DSM_ALLOCATION_OUTPUT;

Membres

Size

Taille de cette structure, y compris la bitmap d’allocation de la dalle, en octets.

Version

Version de cette structure.

SlabSizeInBytes

Taille, en octets, d’une dalle.

SlabOffsetDeltaInBytes

Différence, en octets, entre le décalage spécifié dans la plage du jeu de données et la position de la dalle de départ.

SlabAllocationBitMapBitCount

Nombre de bits dans les dalles de mappage bitmap d’allocation pour la plage de jeu de données.

SlabAllocationBitMapLength

Nombre de valeurs de tableau ULONG contenant la bitmap d’allocation de la dalle.

SlabAllocationBitMap[ANYSIZE_ARRAY]

Bitmap d’allocations de dalles.

Remarques

Les informations d’état d’approvisionnement sont retournées lorsque le membre Action de DEVICE_DSM_INPUT est défini sur DeviceDsmAction_Allocation. L’appelant ne doit inclure qu’une seule plage de jeux de données dans la mémoire tampon système dans DataSetRangesOffset.

Au retour, la mémoire tampon système contient une structure DEVICE_DSM_OUTPUT suivie de la structure DEVICE_DATA_SET_LB_PROVISIONING_STATE. La structure DEVICE_DATA_SET_LB_PROVISIONING_STATE commence à un décalage par rapport au début de la mémoire tampon système spécifiée par OutputBlockOffset dans DEVICE_DSM_OUTPUT.

Chaque bit de la bitmap d’allocation représente un mappage de dalles dans la plage de jeu de données demandée. Les bits correspondent directement aux dalles de la plage du jeu de données. Cela signifie que le bit 0 dans la bitmap marque la première dalle de la plage. Une dalle est mappée si la valeur de bit = 1 et non mappée si la valeur de bit = 0.

L’espace pour SlabAllocationBitMap doit être alloué en fonction du nombre de dalles possibles dans la plage de jeu de données demandée. La valeur SlabAllocationBitMapLength de la bitmap retournée est (nombre de dalles / 32) + ((nombre de dalles MOD 32) > 0 ? 1 : 0).

La taille de la dalle est déterminée par le membre OptimalUnmapGranularity de DEVICE_LB_PROVISIONING_DESCRIPTOR retourné à partir d’une demande de IOCTL_STORAGE_QUERY_PROPERTY . La longueur de la plage de jeux de données fournie doit être un multiple d’OptimalUnmapGranularity. Lorsque la longueur de plage n’est pas un multiple d’OptimalUnmapGranularity, elle est réduite à un multiple.

Si le décalage de départ dans la plage du jeu de données n’est pas aligné sur une limite de dalle, un multiple d’OptimalUnmapGranularity, le décalage est ajusté à la limite suivante. La différence entre le décalage demandé et le décalage ajusté est retournée dans SlabOffsetDeltaInBytes.

Si le total d’allocation de la dalle retourné dans SlabAllocationBitMapBitCount n’est pas comme prévu en raison des ajustements d’alignement ou de longueur du jeu de données, une requête supplémentaire peut être envoyée avec une plage de jeux de données modifiée en fonction des valeurs de SlabAllocationBitMapBitCount et SlabOffsetDeltaInBytes. La nouvelle plage sélectionne correctement les dalles laissées hors de la bitmap retournée par la requête précédente.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 8.
En-tête	ntddstor.h (inclure Ntddstor.h)

Voir aussi

DEVICE_DSM_ACTION Descriptions

DEVICE_DSM_INPUT

IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES

IOCTL_STORAGE_QUERY_PROPERTY