GET_VIRTUAL_DISK_INFO 構造体 (virtdisk.h)
仮想ハード ディスク (VHD) 情報が含まれています。
構文
typedef struct _GET_VIRTUAL_DISK_INFO {
GET_VIRTUAL_DISK_INFO_VERSION Version;
union {
struct {
ULONGLONG VirtualSize;
ULONGLONG PhysicalSize;
ULONG BlockSize;
ULONG SectorSize;
} Size;
GUID Identifier;
struct {
BOOL ParentResolved;
WCHAR ParentLocationBuffer[1];
} ParentLocation;
GUID ParentIdentifier;
ULONG ParentTimestamp;
VIRTUAL_STORAGE_TYPE VirtualStorageType;
ULONG ProviderSubtype;
BOOL Is4kAligned;
BOOL IsLoaded;
struct {
ULONG LogicalSectorSize;
ULONG PhysicalSectorSize;
BOOL IsRemote;
} PhysicalDisk;
ULONG VhdPhysicalSectorSize;
ULONGLONG SmallestSafeVirtualSize;
ULONG FragmentationPercentage;
GUID VirtualDiskId;
struct {
BOOL Enabled;
BOOL NewerChanges;
WCHAR MostRecentId[1];
} ChangeTrackingState;
};
} GET_VIRTUAL_DISK_INFO, *PGET_VIRTUAL_DISK_INFO;
メンバー
Version
仮想ディスク関数との間で渡される GET_VIRTUAL_DISK_INFO 構造体のバージョンを指定する GET_VIRTUAL_DISK_INFO_VERSION 列挙の値。 これにより、この構造体の使用部分が決まります。
Size
次のメンバーを持つ 構造体。 [バージョン] メンバーを [GET_VIRTUAL_DISK_INFO_SIZE] に設定します。
Size.VirtualSize
仮想ディスクの仮想サイズ (バイト単位)。
Size.PhysicalSize
物理ディスク上の仮想ディスクの物理サイズ (バイト単位)。
Size.BlockSize
仮想ディスクのブロック サイズ (バイト単位)。
Size.SectorSize
仮想ディスクのセクター サイズ (バイト単位)。
Identifier
仮想ディスクの一意識別子。 [バージョン] メンバーを [GET_VIRTUAL_DISK_INFO_IDENTIFIER] に設定します。
ParentLocation
次のメンバーを持つ 構造体。 [バージョン] メンバーを [GET_VIRTUAL_DISK_INFO_PARENT_LOCATION] に設定します。
ParentLocation.ParentResolved
親解決。 親バッキング ストアが正常に解決された場合は TRUE、解決されない場合は FALSE。
ParentLocation.ParentLocationBuffer[1]
ParentResolved メンバーが TRUE の場合は、親バッキング ストアのパスが含まれます。
ParentResolved メンバーが FALSE の場合、検索リストに存在するすべての親パスが含まれます。
ParentIdentifier
親ディスク バッキング ストアの一意識別子。 [バージョン] メンバーを [GET_VIRTUAL_DISK_INFO_PARENT_IDENTIFIER] に設定します。
ParentTimestamp
親ディスク バッキング ストアの内部タイム スタンプ。 [バージョン] メンバーを [GET_VIRTUAL_DISK_INFO_PARENT_TIMESTAMP] に設定します。
VirtualStorageType
VIRTUAL_STORAGE_TYPE 仮想ディスクの種類に関する情報を含む構造体です。 [バージョン] メンバーを [GET_VIRTUAL_DISK_INFO_VIRTUAL_STORAGE_TYPE] に設定します。
ProviderSubtype
プロバイダー固有のサブタイプ。 [バージョン] メンバーを [GET_VIRTUAL_DISK_INFO_PROVIDER_SUBTYPE] に設定します。
| 値 | 意味 |
|---|---|
|
固定。 |
|
動的に展開可能 (スパース)。 |
|
差分。 |
Is4kAligned
仮想ディスクが 4 KB アラインされているかどうかを示します。 [バージョン] メンバーを [GET_VIRTUAL_DISK_INFO_IS_4K_ALIGNED] に設定します。
Windows 7 と Windows Server 2008 R2: これは、Windows 8およびWindows Server 2012する前にサポートされていません。
IsLoaded
仮想ディスクが現在マウントされていて使用中かどうかを示します。 仮想 ディスクが現在マウントされていて使用中の場合は TRUE。それ以外の場合 は FALSE。 [バージョン] メンバーを [GET_VIRTUAL_DISK_INFO_IS_LOADED] に設定します。
Windows 8とWindows Server 2012: これは、R2 をWindows 8.1してWindows Server 2012する前にサポートされていません。
PhysicalDisk
仮想ディスクが存在する物理ディスクの詳細。 Version メンバーを GET_VIRTUAL_DISK_INFO_PHYSICAL_DISK に設定します。
Windows 7 と Windows Server 2008 R2: これは、Windows 8およびWindows Server 2012する前にサポートされていません。
PhysicalDisk.LogicalSectorSize
物理ディスクの論理セクター サイズ。
PhysicalDisk.PhysicalSectorSize
物理ディスクの物理セクター サイズ。
PhysicalDisk.IsRemote
物理ディスクがリモートであるかどうかを示します。
VhdPhysicalSectorSize
仮想ディスクの物理セクター サイズ。 [バージョン] メンバーを [GET_VIRTUAL_DISK_INFO_VHD_PHYSICAL_SECTOR_SIZE] に設定します。
Windows 7 と Windows Server 2008 R2: これは、Windows 8およびWindows Server 2012する前にサポートされていません。
SmallestSafeVirtualSize
仮想ディスクの最小の安全な最小サイズ。 [バージョン] メンバーを [GET_VIRTUAL_DISK_INFO_SMALLEST_SAFE_VIRTUAL_SIZE] に設定します。
Windows 7 と Windows Server 2008 R2: これは、Windows 8およびWindows Server 2012する前にサポートされていません。
FragmentationPercentage
仮想ディスクの断片化レベル。 [バージョン] メンバーを [GET_VIRTUAL_DISK_INFO_FRAGMENTATION] に設定します。
Windows 7 と Windows Server 2008 R2: これは、Windows 8およびWindows Server 2012する前にサポートされていません。
VirtualDiskId
ユーザーが最初にその仮想ディスクを一意に識別するために仮想ディスクを作成するときに一意に作成される識別子。 Version メンバーを GET_VIRTUAL_DISK_INFO_VIRTUAL_DISK_ID に設定します。
Windows 8とWindows Server 2012: これは、R2 をWindows 8.1してWindows Server 2012する前にサポートされていません。
ChangeTrackingState
仮想ディスクの回復性のある変更追跡 (RCT) の状態。 [バージョン] メンバーを [GET_VIRTUAL_DISK_INFO_CHANGE_TRACKING_STATE] に設定します。
Windows 8.1およびWindows Server 2012 R2: このメンバーは、Windows 10およびWindows Server 2016する前にサポートされていません。
ChangeTrackingState.Enabled
RCT がオンになっているかどうか。 RCT が有効になっている場合は TRUE。それ以外の場合 は FALSE。
ChangeTrackingState.NewerChanges
MostRecentId メンバーによって識別された変更が発生してから仮想ディスクが変更されたかどうか。 MostRecentId メンバーによって識別された変更が発生した後に仮想ディスクが変更された場合は TRUE。それ以外の場合は FALSE。
ChangeTrackingState.MostRecentId[1]
NewerChanges メンバーが新しい変更を報告するかどうかを判断するための比較の基礎として使用する仮想ディスクの状態を識別する変更の変更追跡識別子。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 |
| サポートされている最小のサーバー | Windows Server 2008 R2 |
| Header | virtdisk.h |