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] に設定します。

意味
2
 固定。
3
動的に展開可能 (スパース)。
4
差分。

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

こちらもご覧ください

VHD について

GET_VIRTUAL_DISK_INFO_VERSION

GetVirtualDiskInformation

VHD リファレンス