次の方法で共有

CREATE_VIRTUAL_DISK_PARAMETERS構造体 (virtdisk.h)

  • [アーティクル]

仮想ハード ディスク (VHD) 作成パラメーターが含まれており、新しく作成された仮想ディスクの制御と情報を提供します。

構文

typedef struct _CREATE_VIRTUAL_DISK_PARAMETERS {
  CREATE_VIRTUAL_DISK_VERSION Version;
  union {
    struct {
      GUID      UniqueId;
      ULONGLONG MaximumSize;
      ULONG     BlockSizeInBytes;
      ULONG     SectorSizeInBytes;
      PCWSTR    ParentPath;
      PCWSTR    SourcePath;
    } Version1;
    struct {
      GUID                   UniqueId;
      ULONGLONG              MaximumSize;
      ULONG                  BlockSizeInBytes;
      ULONG                  SectorSizeInBytes;
      ULONG                  PhysicalSectorSizeInBytes;
      PCWSTR                 ParentPath;
      PCWSTR                 SourcePath;
      OPEN_VIRTUAL_DISK_FLAG OpenFlags;
      VIRTUAL_STORAGE_TYPE   ParentVirtualStorageType;
      VIRTUAL_STORAGE_TYPE   SourceVirtualStorageType;
      GUID                   ResiliencyGuid;
    } Version2;
  };
} CREATE_VIRTUAL_DISK_PARAMETERS, *PCREATE_VIRTUAL_DISK_PARAMETERS;

メンバー

Version

共用体の判別式である CREATE_VIRTUAL_DISK_VERSION 列挙からの値。

値 意味
CREATE_VIRTUAL_DISK_VERSION_1
1
 この構造体の Version1 メンバーを使用します。
CREATE_VIRTUAL_DISK_VERSION_2
2
 この構造体の Version2 メンバーを使用します。

Version1

この構造体は、 Version メンバーが (1) CREATE_VIRTUAL_DISK_VERSION_1 場合に使用されます。

Version1.UniqueId

仮想ディスク オブジェクトに割り当てる一意の識別子。 このメンバーが 0 に設定されている場合は、システムによって一意の識別子が作成されます。

Version1.MaximumSize

仮想ディスク オブジェクトの最大仮想サイズ (バイト単位)。 512 の倍数を指定する必要があります。

ParentPath が指定されている場合、この値は 0 である必要があります。

SourcePath が指定されている場合、使用するソース仮想ディスクのサイズを指定するには、この値を 0 にできます。それ以外の場合は、指定したサイズがソース ディスクのサイズ以上である必要があります。

Version1.BlockSizeInBytes

仮想ディスク オブジェクト ブロックの内部サイズ (バイト単位)。 これは、次のいずれかの値に設定する必要があります。

値 意味
CREATE_VIRTUAL_DISK_PARAMETERS_DEFAULT_BLOCK_SIZE
0
 これは既定値であり、2 MB のブロック サイズを表します。
524288 (0x80000)
 ブロック サイズは 512 KB です。
2097152 (0x200000)
 ブロック サイズは 2 MB です

Version1.SectorSizeInBytes

仮想ディスク オブジェクト セクターの内部サイズ。 512 に設定する必要があります。

値 意味
CREATE_VIRTUAL_DISK_PARAMETERS_DEFAULT_SECTOR_SIZE
0x200
 既定の許容サイズ (512 バイトのみ)。

Version1.ParentPath

親仮想ディスク オブジェクトへの オプションの完全修飾 パス。 新しい仮想ディスクを既存の仮想ディスクに関連付けます。

このパラメーターが NULL でない場合、 SourcePath は NULL である必要があります。

Version1.SourcePath

既存のディスクからのブロック データを新しい仮想ディスク オブジェクトに事前設定するための オプションの完全修飾 パス。 このパスは、仮想ディスクまたは物理ディスクを参照する場合があります。

このパラメーターが NULL でない場合、 ParentPath は NULL である必要があります。

Version2

この構造体は、 Version メンバーが (2) CREATE_VIRTUAL_DISK_VERSION_2 場合に使用されます。

Windows 7 と Windows Server 2008 R2: この構造体は、Windows 8してWindows Server 2012するまでサポートされません。

Version2.UniqueId

仮想ディスク オブジェクトに割り当てる一意の識別子。 このメンバーが 0 に設定されている場合は、システムによって一意の識別子が作成されます。

Version2.MaximumSize

仮想ディスク オブジェクトの最大仮想サイズ (バイト単位)。 512 の倍数を指定する必要があります。

ParentPath が指定されている場合、この値は 0 である必要があります。

SourcePath が指定されている場合、使用するソース仮想ディスクのサイズを指定するには、この値を 0 にできます。それ以外の場合は、指定したサイズがソース ディスクのサイズ以上である必要があります。

Version2.BlockSizeInBytes

仮想ディスク オブジェクト ブロックの内部サイズ (バイト単位)。 VHDX の場合、これは 1 ~ 256 MB の 1 MB の倍数である必要があります。 VHD 1 の場合、これは次のいずれかの値に設定する必要があります。

値 意味
CREATE_VIRTUAL_DISK_PARAMETERS_DEFAULT_BLOCK_SIZE
0
 これは既定値であり、2 MB のブロック サイズを表します。 これは、固定 VHD 1 仮想ディスクでサポートされている唯一の値です。
524288 (0x80000)
 ブロック サイズは 512 KB です。 この値は、固定 VHD 1 仮想ディスクではサポートされていません。
2097152 (0x200000)
 ブロック サイズは 2 MB です。 この値は、固定 VHD 1 仮想ディスクではサポートされていません。

Version2.SectorSizeInBytes

仮想ディスク オブジェクト セクターの内部サイズ。 VHDX の場合は、512 (0x200) または 4096 (0x1000) に設定する必要があります。 VHD 1 の場合は、512 に設定する必要があります。

Version2.PhysicalSectorSizeInBytes

Version2.ParentPath

親仮想ディスク オブジェクトへの オプションの完全修飾 パス。 新しい仮想ディスクを既存の仮想ディスクに関連付けます。

このパラメーターが NULL でない場合、 SourcePath は NULL である必要があります。

Version2.SourcePath

既存のディスクからのブロック データを新しい仮想ディスク オブジェクトに事前設定するための オプションの完全修飾 パス。 このパスは、仮想ディスクまたは物理ディスクを参照する場合があります。

このパラメーターが NULL でない場合、 ParentPath は NULL である必要があります。

Version2.OpenFlags

仮想ディスクを開く方法を説明する 、OPEN_VIRTUAL_DISK_FLAG 列挙からの 0 個以上のフラグ。

Version2.ParentVirtualStorageType

ParentPath メンバーで指定された親仮想ディスクを記述するVIRTUAL_STORAGE_TYPE構造体。

Version2.SourceVirtualStorageType

SourcePath メンバーで指定されたソース仮想ディスクを記述するVIRTUAL_STORAGE_TYPE構造体。

Version2.ResiliencyGuid

ファイルの回復性 GUID 。

注意

Version3 および Version4 の前に作成された次のパラメーターは、内部使用を目的としています。

Version3

Version3.UniqueId

Version3.MaximumSize

Version3.BlockSizeInBytes

Version3.SectorSizeInBytes

Version3.PhysicalSectorSizeInBytes

Version3.ParentPath

Version3.SourcePath

Version3.OpenFlags

Version3.ParentVirtualStorageType

Version3.SourceVirtualStorageType

Version3.ResiliencyGuid

Version3.SourceLimitPath

Version3.BackingStorageType

Version4

Version4.UniqueId

Version4.MaximumSize

Version4.BlockSizeInBytes

Version4.SectorSizeInBytes

Version4.PhysicalSectorSizeInBytes

Version4.ParentPath

Version4.SourcePath

Version4.OpenFlags

Version4.ParentVirtualStorageType

Version4.SourceVirtualStorageType

Version4.ResiliencyGuid

Version4.SourceLimitPath

Version4.BackingStorageType

Version4.PmemAddressAbstractionType

Version4.DataAlignment

要件

要件 値
サポートされている最小のクライアント Windows 7
サポートされている最小のサーバー Windows Server 2008 R2
Header virtdisk.h

こちらもご覧ください

VHD について

CreateVirtualDisk

ファイル、パス、名前空間の名前付け

VHD リファレンス

VHD 構造体