VDS_POOL_ATTRIBUTES 構造体 (vdshwprv.h)
[Windows 8とWindows Server 2012以降、Virtual Disk Service 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 構造体のメンバーに対応します。 未使用のビットは予約されています。
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 [デスクトップ アプリのみ] |
| Header | vdshwprv.h |