IOCTL_DISK_GET_PARTITION_INFO_EX IOCTL (winioctl.h)

  • Artikel

Ruft erweiterte Informationen über den Typ, die Größe und die Art einer Datenträgerpartition ab.

Um diesen Vorgang auszuführen, rufen Sie die Funktion DeviceIoControl mit den folgenden Parametern auf.

BOOL DeviceIoControl(
  (HANDLE) hDevice,                 // handle to a partition
  IOCTL_DISK_GET_PARTITION_INFO_EX, // 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
);

Hinweise

Der IOCTL_DISK_GET_PARTITION_INFO_EX-Steuerungscode wird auf Basisdatenträgern unterstützt. Sie wird nur auf dynamischen Datenträgern unterstützt, bei denen es sich um Start- oder Systemdatenträger handelt oder die Einträge in der Partitionstabelle beibehalten haben. Der DiskPart.exe Befehl RETAIN kann dazu für andere dynamische einfache Partitionen verwendet werden.

Die Datenträgerunterstützung kann wie folgt zusammengefasst werden.

Datenträgertyp IOCTL_DISK_GET_PARTITION_INFO IOCTL_DISK_GET_PARTITION_INFO_EX
Basic master Boot Record (MBR) Yes Yes
Grundlegende GUID-Partitionstabelle (GPT) Nein Ja
Dynamischer MBR-Start/-System Yes Yes
Dynamische MBR-Daten Ja Nein
Dynamischer GPT-Start/-System Nein Ja
Dynamische GPT-Daten No No

Derzeit wird GPT nur auf 64-Bit-Systemen unterstützt.

Wenn sich die Partition auf einem Datenträger befindet, der als Typ master Startdatensatz (MBR) formatiert ist, ist die Partitionsgröße insgesamt begrenzt. Weitere Informationen finden Sie im Abschnitt Hinweise von IOCTL_DISK_SET_DRIVE_LAYOUT.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile winioctl.h (windows.h einschließen)

Weitere Informationen