VDS_POOL_ATTRIBUTES 構造体 (vds.h)

  • [アーティクル]

[Windows 8とWindows Server 2012以降、仮想ディスク サービス COM インターフェイスは Windows Storage Management API に置き換えられます。

記憶域プールの属性を定義します。

構文

typedef struct _VDS_POOL_ATTRIBUTES {
  ULONGLONG                  ullAttributeMask;
  VDS_RAID_TYPE              raidType;
  VDS_STORAGE_BUS_TYPE       busType;
  LPWSTR                     pwszIntendedUsage;
  BOOL                       bSpinDown;
  BOOL                       bIsThinProvisioned;
  ULONGLONG                  ullProvisionedSpace;
  BOOL                       bNoSinglePointOfFailure;
  ULONG                      ulDataRedundancyMax;
  ULONG                      ulDataRedundancyMin;
  ULONG                      ulDataRedundancyDefault;
  ULONG                      ulPackageRedundancyMax;
  ULONG                      ulPackageRedundancyMin;
  ULONG                      ulPackageRedundancyDefault;
  ULONG                      ulStripeSize;
  ULONG                      ulStripeSizeMax;
  ULONG                      ulStripeSizeMin;
  ULONG                      ulDefaultStripeSize;
  ULONG                      ulNumberOfColumns;
  ULONG                      ulNumberOfColumnsMax;
  ULONG                      ulNumberOfColumnsMin;
  ULONG                      ulDefaultNumberofColumns;
  ULONG                      ulDataAvailabilityHint;
  ULONG                      ulAccessRandomnessHint;
  ULONG                      ulAccessDirectionHint;
  ULONG                      ulAccessSizeHint;
  ULONG                      ulAccessLatencyHint;
  ULONG                      ulAccessBandwidthWeightHint;
  ULONG                      ulStorageCostHint;
  ULONG                      ulStorageEfficiencyHint;
  ULONG                      ulNumOfCustomAttributes;
  VDS_POOL_CUSTOM_ATTRIBUTES *pPoolCustomAttributes;
  BOOL                       bReserved1;
  BOOL                       bReserved2;
  ULONG                      ulReserved1;
  ULONG                      ulReserved2;
  ULONGLONG                  ullReserved1;
  ULONGLONG                  ullReserved2;
} VDS_POOL_ATTRIBUTES, *PVDS_POOL_ATTRIBUTES;

メンバー

ullAttributeMask

この記憶域プールによって定義される構造体内の属性を指定するマスク。

有効な属性フラグの一覧は次のとおりです。 各フラグは、 VDS_POOL_ATTRIBUTES 構造体のメンバーに対応します。 未使用のビットは予約されています。

値 記憶域プールによって定義される属性
VDS_POOL_ATTRIB_RAIDTYPE
0x1L
 raidType
VDS_POOL_ATTRIB_BUSTYPE
0x2L
 busType
VDS_POOL_ATTRIB_ALLOW_SPINDOWN
0x4L
 bSpinDown
VDS_POOL_ATTRIB_THIN_PROVISION
0x8L
 bIsThinProvisioned
VDS_POOL_ATTRIB_NO_SINGLE_POF
0x10L
 bNoSinglePointOfFailure
VDS_POOL_ATTRIB_DATA_RDNCY_MAX
0x20L
 ulDataRedundancyMax
VDS_POOL_ATTRIB_DATA_RDNCY_MIN
0x40L
 ulDataRedundancyMin
VDS_POOL_ATTRIB_DATA_RDNCY_DEF
0x80L
 ulDataRedundancyDefault
VDS_POOL_ATTRIB_PKG_RDNCY_MAX
0x100L
 ulPackageRedundancyDefault
VDS_POOL_ATTRIB_PKG_RDNCY_MIN
0x200L
 ulPackageRedundancyMin
VDS_POOL_ATTRIB_PKG_RDNCY_DEF
0x400L
 ulPackageRedundancyDefault
VDS_POOL_ATTRIB_STRIPE_SIZE
0x800L
 ulStripeSize
VDS_POOL_ATTRIB_STRIPE_SIZE_MAX
0x1000L
 ulStripeSizeMax
VDS_POOL_ATTRIB_STRIPE_SIZE_MIN
0x2000L
 ulStripeSizeMin
VDS_POOL_ATTRIB_STRIPE_SIZE_DEF
0x4000L
 ulDefaultStripeSize
VDS_POOL_ATTRIB_NUM_CLMNS
0x8000L
 ulNumberOfColumns
VDS_POOL_ATTRIB_NUM_CLMNS_MAX
0x10000L
 ulNumberOfColumnsMax
VDS_POOL_ATTRIB_NUM_CLMNS_MIN
0x20000L
 ulNumberOfColumnsMin
VDS_POOL_ATTRIB_NUM_CLMNS_DEF
0x40000L
 ulDefaultNumberofColumns
VDS_POOL_ATTRIB_DATA_AVL_HINT
0x80000L
 ulDataAvailabilityHint
VDS_POOL_ATTRIB_ACCS_RNDM_HINT
0x100000L
 ulAccessRandomnessHint
VDS_POOL_ATTRIB_ACCS_DIR_HINT
0x200000L
 ulAccessDirectionHint
VDS_POOL_ATTRIB_ACCS_SIZE_HINT
0x400000L
 ulAccessSizeHint
VDS_POOL_ATTRIB_ACCS_LTNCY_HINT
0x800000L
 ulAccessLatencyHint
VDS_POOL_ATTRIB_ACCS_BDW_WT_HINT
0x1000000L
 ulAccessBandwidthWeightHint
VDS_POOL_ATTRIB_STOR_COST_HINT
0x2000000L
 ulStorageCostHint
VDS_POOL_ATTRIB_STOR_EFFCY_HINT
0x4000000L
 ulStorageEfficiencyHint
VDS_POOL_ATTRIB_CUSTOM_ATTRIB
0x8000000L
 pPoolCustomAttributes

raidType

記憶域プール の RAID の種類を指定するVDS_RAID_TYPE列挙値。 記憶域プールに特定の RAID タイプがない場合は、このメンバーを VDS_RT_UNKNOWN に設定し、ullAttributeMask メンバーのVDS_POOL_ATTRIB_RAIDTYPE属性フラグをクリアします。

busType

記憶域プール 内の ドライブのバスの種類を指定するVDS_STORAGE_BUS_TYPE列挙値。

pwszIntendedUsage

記憶域プールの使用状況を示す文字列。 通常、これは、記憶域プール ("SQL" や "Exchange" など) を使用しているアプリケーション、または記憶域プールを使用しているビジネス関数 ("Finance" や "Human Resources" など) を示している場合があります。

bSpinDown

記憶域 プール内のドライブが自動的にスピンダウンして電力使用量を減らす場合は TRUE、それ以外の場合 は FALSE 。

bIsThinProvisioned

記憶域プールがシン プロビジョニングされている場合は TRUE、それ以外の場合は FALSE。 プールがシン プロビジョニングされている場合、プールの消費領域のバイト数が、プールのプロビジョニング済み領域のバイト数より少なくなる可能性があります。 (プロビジョニングされた領域のバイト数は、この構造体の ullProvisionedSpace メンバーに格納されます。使用領域のバイト数は、VDS_STORAGE_POOL_PROP構造体の ullTotalConsumedSpace メンバーに格納されます)。ハードウェア プロバイダーがこのメンバーを TRUE に設定する場合は、VDS_STORAGE_POOL_PROP構造体の型メンバーも VDS_SPT_CONCRETE に設定する必要があります。

ullProvisionedSpace

プールがシン プロビジョニングされている場合、このメンバーはプールにプロビジョニングされる領域をバイト単位で指定します。 このメンバーの値は、VDS_STORAGE_POOL_PROP構造体の ullTotalConsumedSpace メンバーの値以上である必要があります。

bNoSinglePointOfFailure

プールに単一障害点がない場合は TRUE、それ以外の場合は FALSE。

ulDataRedundancyMax

この記憶域プールに保持できるデータの完全なコピーの最大数。

ulDataRedundancyMin

この記憶域プールに保持できるデータの完全なコピーの最小数。

ulDataRedundancyDefault

この記憶域プールに保持されているデータの完全なコピーの既定の数。

ulPackageRedundancyMax

パッケージの冗長性を確保するために記憶域プールで使用できるドライブの最大数。 パッケージの冗長性は、データが失われることなく記憶域プールで障害が発生する可能性があるドライブの数を示します。

ulPackageRedundancyMin

パッケージの冗長性を確保するために記憶域プールで使用できるドライブの最小数。 パッケージの冗長性は、データが失われることなく記憶域プールで障害が発生する可能性があるドライブの数を示します。

ulPackageRedundancyDefault

パッケージの冗長性を確保するために記憶域プールで使用されるドライブの既定の数。 パッケージの冗長性は、データが失われることなく記憶域プールで障害が発生する可能性があるドライブの数を示します。

ulStripeSize

プールがストライピングされている場合 (パリティの有無にかかわらず) 記憶域プールのミラーまたはパリティ ストライプ サイズ (バイト単位)。

ulStripeSizeMax

記憶域プールでサポートされる最大ストライプ サイズ (バイト単位)。

ulStripeSizeMin

記憶域プールでサポートされている最小ストライプ サイズ (バイト単位)。

ulDefaultStripeSize

ストレージ プールでサポートされる既定のストライプ サイズ (バイト単位)。

ulNumberOfColumns

プールがストライピングされている場合 (パリティの有無にかかわらず) 記憶域プールの列数。

ulNumberOfColumnsMax

記憶域プールでサポートされる列の最大数。

ulNumberOfColumnsMin

記憶域プールでサポートされる列の最小数。

ulDefaultNumberofColumns

記憶域プールでサポートされる列の既定の数。

ulDataAvailabilityHint

データの可用性に対する重要度を示すクライアントからのヒント。 値の範囲は 0 (重要ではありません) から 10 (非常に重要) です。

ulAccessRandomnessHint

データ アクセスのランダム性を示すクライアントからのヒント。 値の範囲は 0 (完全にシーケンシャル) から 10 (完全にランダム) です。

ulAccessDirectionHint

データ アクセスの方向を示すクライアントからのヒント。 値の範囲は 0 (完全読み取り) から 10 (完全書き込み) です。

ulAccessSizeHint

最適なアクセス サイズをメガバイト単位で示すクライアントからのヒント。

ulAccessLatencyHint

クライアントへのアクセス待機時間の重要性を示すクライアントからのヒント。 値の範囲は 0 (重要ではありません) から 10 (非常に重要) です。

ulAccessBandwidthWeightHint

高帯域幅の重要性を示すクライアントからのヒント。 値の範囲は 0 (重要ではありません) から 10 (非常に重要) です。

ulStorageCostHint

クライアントに対するストレージ コストの重要性を示すクライアントからのヒント。 値の範囲は 0 (重要ではありません) から 10 (非常に重要) です。 ストレージ コストがクライアントにとって非常に重要な場合、値 10 は、クライアントが低コストのストレージを使用してプールをプロビジョニングすることを好むことを示します。

ulStorageEfficiencyHint

クライアントに対するストレージ効率の重要性を示すクライアントからのヒント。 値の範囲は 0 (重要ではありません) から 10 (非常に重要) です。

ulNumOfCustomAttributes

記憶域プールに対して定義されているカスタム属性の数。

pPoolCustomAttributes

VDS_POOL_CUSTOM_ATTRIBUTES構造体の配列。 各構造体には、記憶域プールに対して定義されたカスタム属性が含まれています。

bReserved1

このメンバーは将来使用するために予約されています。 使用しないでください。

bReserved2

このメンバーは将来使用するために予約されています。 使用しないでください。

ulReserved1

このメンバーは将来使用するために予約されています。 使用しないでください。

ulReserved2

このメンバーは将来使用するために予約されています。 使用しないでください。

ullReserved1

このメンバーは将来使用するために予約されています。 使用しないでください。

ullReserved2

このメンバーは将来使用するために予約されています。 使用しないでください。

注釈

ストレージ・プールに属性が設定されている場合、その属性設定は、プールを構成するすべてのドライブ・エクステントに適用する必要があります。

要件

   
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリのみ]
ヘッダー vds.h

こちらもご覧ください

IVdsHwProviderStoragePools::QueryStoragePools

IVdsStoragePool::GetAttributes