CREATE_PARTITION_PARAMETERS 結構 (vds.h)

  • 發行項

[從 Windows 8 和 Windows Server 2012 開始，虛擬磁碟服務 COM 介面會由 Windows 記憶體管理 API 取代。

定義數據分割樣式的數據分割參數。

語法

typedef struct _CREATE_PARTITION_PARAMETERS {
  VDS_PARTITION_STYLE style;
  union {
    struct {
      BYTE    partitionType;
      BOOLEAN bootIndicator;
    } MbrPartInfo;
    struct {
      GUID      partitionType;
      GUID      partitionId;
      ULONGLONG attributes;
      WCHAR     name[36];
    } GptPartInfo;
  };
} CREATE_PARTITION_PARAMETERS;

成員

style

MbrPartInfo

主要開機記錄 (MBR) 磁碟的參數。 如果樣式VDS_PST_MBR，則會使用 。

MbrPartInfo.partitionType

表示系統定義的 MBR 磁碟分區類型。 可能值如下所示：

值 意義
PARTITION_ENTRY_UNUSED
0x00
 未使用的專案。
PARTITION_FAT_12
0x01
 指定具有12位 FAT 專案的分割區。
PARTITION_XENIX_1
0x02
 指定 XENIX 類型 1 資料分割。
PARTITION_XENIX_2
0x03
 指定 XENIX 類型 2 資料分割。
PARTITION_FAT_16
0x04
 指定具有16位 FAT 專案的分割區。
PARTITION_EXTENDED
0x05
 指定 MS-DOS V4 擴充數據分割。
PARTITION_HUGE
0x06
 指定 MS-DOS V4 大型分割區。 這個值表示數據分割上沒有 Microsoft 檔案系統。 建立邏輯磁碟區時，請使用此值。
PARTITION_IFS
0x07
 指定NTFS或ExFAT磁碟分區。
PARTITION_OS2BOOTMGR
0x0A
 指定 OS/2 開機管理員、OPUS 或一致交換分割區。
PARTITION_FAT32
0x0B
 指定 FAT32 資料分割。
PARTITION_FAT32_XINT13
0x0C
 不支援此值。
PARTITION_XINT13
0x0E
 不支援此值。
PARTITION_XINT13_EXTENDED
0x0F
 不支援此值。
PARTITION_PREP
0x41
 指定 PowerPC 參考平臺分割區。
PARTITION_LDM
0x42
 指定邏輯磁碟管理員磁碟分區。
PARTITION_UNIX
0x63
 指定 UNIX 磁碟分區。
PARTITION_NTFT
0x80
 指定 NTFT 分割區。 這個值會搭配使用 (，也就是以位邏輯方式使用 ORed) 與此數據表中的其他值。

MbrPartInfo.bootIndicator

如果 為TRUE，則分割區為使用中且可開機;否則，磁碟分區無法用來開機系統。

GptPartInfo

GUID 資料分割數據表 (GPT) 磁碟的參數。 如果樣式VDS_PST_GPT，則會使用 。

GptPartInfo.partitionType

數據分割類型的 GUID。

值 意義
PARTITION_ENTRY_UNUSED_GUID
00000000-0000-0000-0000-000000000000
 沒有分割區。

這個屬性可以針對基本和動態磁碟進行設定。
PARTITION_SYSTEM_GUID
c12a7328-f81f-11d2-ba4b-00a0c93ec93b
 分割區是EFI系統分割區。

這個屬性可以針對基本和動態磁碟進行設定。
PARTITION_MSFT_RESERVED_GUID
e3c9e316-0b5c-4db8-817d-f92df00215ae
 分割區是 Microsoft 保留的數據分割。

這個屬性可以針對基本和動態磁碟進行設定。
PARTITION_BASIC_DATA_GUID
ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
 Windows 所建立和辨識的數據分割類型。

只有此類型的分割區可以指派驅動器號、接收磁碟區 GUID 路徑、裝載的資料夾 (也稱為磁碟區裝入點) ，並透過呼叫 FindFirstVolume 和 FindNextVolume 來列舉。

此值只能針對基本磁碟設定，但有一個例外狀況。 如果PARTITION_BASIC_DATA_GUID和GPT_ATTRIBUTE_PLATFORM_REQUIRED是針對後續轉換成動態磁碟之基本磁碟上的分割區設定，即使磁碟的其餘部分是動態磁碟，分割區仍會維持基本分割區。 這是因為分割區會被視為 GPT 磁碟上的 OEM 磁碟分區。
PARTITION_LDM_METADATA_GUID
5808c8aa-7e8f-42e0-85d2-e1e90434cfb3
 分割區是動態磁碟上的邏輯磁碟管理員 (LDM) 元數據分割區。

此值只能針對動態磁碟設定。
PARTITION_LDM_DATA_GUID
af9b60a0-1431-4f62-bc68-3311714a69ad
 分割區是動態磁碟上的LDM數據分割區。

此值只能針對動態磁碟設定。
PARTITION_MSFT_RECOVERY_GUID
de94bba4-06d1-4d40-a16a-bfd50179d6ac
 分割區是 Microsoft 復原磁碟分區。

這個屬性可以針對基本和動態磁碟進行設定。

GptPartInfo.partitionId

如果分割區的標識碼。 如果設定為建立時GUID_NULL (0) ，將會產生唯一值。

GptPartInfo.attributes

數據分割的屬性。 可為下列一或多個值：

值 意義
GPT_ATTRIBUTE_PLATFORM_REQUIRED
0x0000000000000001
 如果設定這個屬性，計算機需要分割區才能正常運作。

例如，必須針對 OEM 磁碟分區設定這個屬性。 請注意，如果已設定此屬性，您可以使用 DiskPart.exe 公用程式來執行數據分割作業，例如刪除數據分割。 不過，因為分割區不是磁碟區，所以您無法使用 DiskPart.exe 公用程式在分割區上執行磁碟區作業。

這個屬性可以針對基本和動態磁碟進行設定。 如果已針對基本磁碟上的分割區設定，且磁碟會轉換成動態磁碟，即使磁碟的其餘部分是動態磁碟，分割區仍會維持基本分割區。 這是因為分割區會被視為 GPT 磁碟上的 OEM 磁碟分區。
GPT_BASIC_DATA_ATTRIBUTE_NO_DRIVE_LETTER
0x8000000000000000
 如果設定這個屬性，當磁碟移至另一部計算機或計算機第一次看到磁碟時，磁碟分區預設不會收到驅動器號。

這個屬性在存放區域網路 (SAN) 環境中很有用。

雖然其名稱為 ，但此屬性仍可針對基本和動態磁碟進行設定。
GPT_BASIC_DATA_ATTRIBUTE_HIDDEN
0x4000000000000000
 如果已設定這個屬性，掛接管理員不會偵測數據分割。

因此，磁碟分區不會收到驅動器號、未接收磁碟區 GUID 路徑、不會裝載掛接的資料夾 (也稱為磁碟區裝入點) ，而且不會透過呼叫 FindFirstVolume 和 FindNextVolume 來列舉。 這可確保磁碟重組器之類的應用程式不會存取磁碟分區。 磁碟區陰影複製服務 (VSS) 會使用此屬性。

雖然其名稱為 ，但此屬性仍可針對基本和動態磁碟進行設定。
GPT_BASIC_DATA_ATTRIBUTE_SHADOW_COPY
0x2000000000000000
 如果設定這個屬性，分割區是另一個分割區的陰影複本。

磁碟區陰影複製服務會使用此屬性 (VSS) 。 此屬性表示文件系統篩選驅動程式型軟體 (例如防病毒軟體程式) ，以避免附加至磁碟區。

應用程式可以使用 屬性來區分陰影複製磁碟區與生產磁碟區。 例如，執行快速復原的應用程式會清除只讀和隱藏屬性和此屬性，以中斷陰影複製 LUN。 當陰影複製建立並清除陰影複製中斷時，就會設定這個屬性。

雖然其名稱為 ，但此屬性仍可針對基本和動態磁碟進行設定。

Windows Server 2003： Windows Server 2003 SP1 之前不支援此屬性。
GPT_BASIC_DATA_ATTRIBUTE_READ_ONLY
0x1000000000000000
 如果設定這個屬性，則分割區是唯讀的。

寫入數據分割的所有要求都會失敗。
如果 文件系統存在，IOCTL_DISK_IS_WRITABLE將會失敗，並出現ERROR_WRITE_PROTECT Win32 錯誤碼，這會導致文件系統掛接為只讀。

VSS 會使用這個屬性。

請勿為動態磁碟設定此屬性。 設定可能會導致 I/O 錯誤，並防止文件系統正確掛接。

GptPartInfo.name[36]

Null 終止的 Unicode 字串，指定數據分割的名稱。

備註

IVdsAdvancedDisk：：CreatePartition 方法會將這個結構當做自變數傳遞，以指定一組參數。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
標頭 vds.h

另請參閱

IVdsAdvancedDisk：：CreatePartition

VDS 結構

VDS_PARTITION_STYLE