IOCTL_DISK_GET_PARTITION_INFO IOCTL (winioctl.h)
擷取磁碟分區的類型、大小和本質的相關信息。
注意
IOCTL_DISK_GET_PARTITION_INFO 會由 IOCTL_DISK_GET_PARTITION_INFO_EX 取代，它會擷取 AT 和 Extensible Firmware Interface (EFI) 分割區的數據分割資訊。
若要執行這項作業，請使用下列參數呼叫 DeviceIoControl 函 式。
BOOL DeviceIoControl(
(HANDLE) hDevice, // handle to a partition
IOCTL_DISK_GET_PARTITION_INFO, // dwIoControlCode
NULL, // lpInBuffer
0, // nInBufferSize
(LPVOID) lpOutBuffer, // output buffer
(DWORD) nOutBufferSize, // size of output buffer
(LPDWORD) lpBytesReturned, // number of bytes returned
(LPOVERLAPPED) lpOverlapped // OVERLAPPED structure
);
備註
只有 MBR 格式磁碟支援 IOCTL_DISK_GET_PARTITION_INFO 控制程式代碼。
磁碟支援可以摘要如下。
| 磁碟類型 | IOCTL_DISK_GET_PARTITION_INFO | IOCTL_DISK_GET_PARTITION_INFO_EX |
|---|---|---|
| (MBR) 的基本主啟動記錄 | Yes | Yes |
| GPT (GPT) 的基本 GUID 分割區數據表 | No | Yes |
| 動態 MBR 開機/系統 | Yes | Yes |
| 動態 MBR 數據 | 是 | No |
| 動態 GPT 開機/系統 | No | Yes |
| 動態 GPT 數據 | No | No |
目前只有 64 位系統上才支援 GPT。
如果磁碟上的磁碟格式化為主要開機記錄類型 (MBR) ，則分割區大小總計會受到限制。 如需詳細資訊，請參閱 IOCTL_DISK_SET_DRIVE_LAYOUT的一節。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
| 標頭 | winioctl.h (包含 Windows.h) |