DEVICE_DATA_SET_LB_PROVISIONING_STATE結構 (winioctl.h)

IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES控制項程式碼之DeviceDsmAction_Allocation動作的輸出結構。

語法

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

成員

Size

這個結構的大小，包括點陣圖，以位元組為單位。

Version

這個 結構的版本。

SlabSizeInBytes

平板的大小，以位元組為單位。

SlabOffsetDeltaInBytes

如果指定的範圍未對齊在DEVICE_LB_PROVISIONING_DESCRIPTOR結構中所傳回的OptimalUnmapGranularity，則 SlabAllocationBitMap中代表的資料會從這個數量所指定的範圍位移。

SlabAllocationBitMapBitCount

點陣圖中相關位的數目。

SlabAllocationBitMapLength

點陣圖陣列中的 DWORD數目。

SlabAllocationBitMap[ANYSIZE_ARRAY]

配置點陣圖，包含每個平板的一個位。 如果設定了位，則會配置對應的平板。 否則，如果位是清楚的，對應的平板就會取消配置。

備註

當DEVICE_MANAGE_DATA_SET_ATTRIBUTES結構的Action成員設定為DeviceDsmAction_Allocation時，就會傳回布建狀態資訊。 呼叫端應該只會在 DataSetRangesOffset的系統緩衝區中包含一個資料集範圍。

傳回時，系統緩衝區包含 DEVICE_MANAGE_DATA_SET_ATTRIBUTES_OUTPUT 結構，後面接著 DEVICE_DATA_SET_LB_PROVISIONING_STATE 結構。 DEVICE_DATA_SET_LB_PROVISIONING_STATE結構會從outputBlockOffset在DEVICE_MANAGE_DATA_SET_ATTRIBUTES_OUTPUT中指定的系統緩衝區開頭開始位移。

配置點陣圖中的每個位都代表所要求資料集範圍內的平板對應。 位會直接對應至資料集範圍內的平板。 這表示點陣圖中的位 0 會標示範圍中的第一個平板。 如果位值 = 1，而且如果位值 = 0，則會對應平板。

SlabAllocationBitMap的空間應該根據所要求資料集範圍內的可能平板數目來配置。 傳回之點陣圖的 SlabAllocationBitMapLength 為 (number_of_slabs / 32) + ((number_of_slabs MOD 32) > 0 ? 1 : 0) 。

平板大小是由從IOCTL_STORAGE_QUERY_PROPERTY控制項程式碼傳回之DEVICE_LB_PROVISIONING_DESCRIPTOR結構的OptimalUnmapGranularity成員所決定。 提供的資料集範圍的長度應該是 OptimalUnmapGranularity的倍數。 當範圍長度不是 OptimalUnmapGranularity的倍數時，它會縮減為倍數。

如果資料集範圍的起始位移未對齊平板界限， 則為 OptimalUnmapGranularity的倍數，則會將位移調整為下一個界限。 在 SlabOffsetDeltaInBytes中會傳回所要求的位移和調整位移之間的差異。

如果 SlabAllocationBitMapBitCount 中傳回的平板配置總計未如預期般，因為資料集範圍對齊或長度調整，可能會根據 SlabAllocationBitMapBitCount 和 SlabOffsetDeltaInBytes中的值來提交額外的要求。 新範圍會正確選取上一個要求所傳回之點陣圖剩餘的平板。

例如，如果要求的平板大小太大， (例如，如果大於 HBA) 的最大傳輸長度，則IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES可能會失敗並ERROR_INVALID_PARAMETER。

規格需求

另請參閱

DEVICE_LB_PROVISIONING_DESCRIPTOR

裝置管理 結構

IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES