IoWritePartitionTableEx 函式 (ntddk.h)

IoWritePartitionTableEx 例程會針對指定裝置物件所代表磁碟上每個分割區，從數據分割清單緩衝區中的專案寫入數據分割數據表。

語法

NTSTATUS IoWritePartitionTableEx(
  [in] PDEVICE_OBJECT               DeviceObject,
       _DRIVE_LAYOUT_INFORMATION_EX *DriveLayout
);

[in] DeviceObject

裝置物件的指標，代表要寫入其數據分割數據表的磁碟。

DriveLayout

磁碟驅動器配置緩衝區的指標，其中包含數據分割清單專案。如需詳細資訊 ，請參閱 DRIVE_LAYOUT_INFORMATION_EX。

如果所有寫入都已完成且沒有錯誤，IoWritePartitionTableEx 會傳回狀態代碼STATUS_SUCCESS。如果失敗， IoWritePartitionTableEx 傳回的錯誤碼可能包含下列清單，但不限於：

傳回碼	Description
STATUS_DEVICE_NOT_READY	表示讀取正確的磁碟幾何失敗。
STATUS_INSUFFICIENT_RESOURCES	表示 ( (配置必要資源失敗，例如堆積記憶體、IRP 等) 。
STATUS_UNSUCCESSFUL	表示扇區零沒有預期的 MBR 磁碟簽章。

IoWritePartitionTableEx 會取代過時的例程 IoWritePartitionTable。不同於較舊的例程，它可以寫入 GUID 數據分割數據表以及主啟動記錄數據分割數據表。

IoWritePartitionTableEx 只能由磁碟驅動器使用。其他驅動程式應該改用 IOCTL_DISK_SET_DRIVE_LAYOUT_EX 磁碟 I/O 要求。

當磁碟設備驅動器收到IRP_MJ_DEVICE_CONTROL要求來設定分割區數據表專案中的磁碟分區類型，或重新分割磁碟時，它應該呼叫 IoWritePartitionTableEx。裝置控制要求通常是由格式公用程序發出，它會在電腦上的磁碟分區和磁碟上執行 I/O 控制函式。

若要重設磁碟分區類型，驅動程式會將指標傳遞至裝置物件，代表實體磁碟，以及與格式公用程式已開啟之裝置對象相關聯的磁碟分區數目。當磁碟要動態重新分割時，磁碟驅動器必須卸除其代表目前磁碟分區的一組裝置物件，並建立代表磁碟上新磁碟分區的新裝置物件集。

若要建立或刪除分割區，必須透過呼叫 IoReadPartitionTableEx 來取得系統的完整描述。系統格式公用程式可以修改磁碟驅動器配置結構，以反映磁碟的新設定。

IoWritePartitionTableEx 是同步的。它必須由磁碟驅動程式的 Dispatch 例程或驅動程式線程呼叫。因此，發出裝置控制要求來重設裝置的分割區類型時，所有使用者和文件系統線程都必須準備好進入等候狀態。

需求	值
目標平台	Universal
標頭	ntddk.h (包含 Ntddk.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI 合規性規則	HwStorPortProhibitedDIS (storport) 、 PowerIrpDDis (wdm)