Fonction IoReadPartitionTableEx (ntddk.h)

Article
02/07/2025

La routine IoReadPartitionTableEx lit une liste de partitions sur un disque ayant une taille de secteur spécifiée et crée une entrée dans la liste de partitions pour chaque partition reconnue.

Syntaxe

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

Paramètres

[in] DeviceObject

Pointeur vers l’objet d’appareil pour le disque dont les partitions doivent être lues.

DriveLayout

Pointeur vers une adresse non initialisée. Si elle réussit, IoReadPartitionTableEx alloue la mémoire pour cette mémoire tampon à partir d’un pool non paginé et retourne les informations de disposition du lecteur dans celle-ci.

Valeur de retour

Cette routine retourne une valeur de STATUS_SUCCESS si au moins une table de secteur a été lue. Sinon, elle retourne une valeur d’état d’erreur et définit le pointeur à PartitionBuffer sur NULL.

Remarques

IoReadPartitionTableEx ne doit être utilisé que par les pilotes de disque. D’autres pilotes doivent utiliser la demande d’E/S de disque IOCTL_DISK_GET_DRIVE_LAYOUT_EX à la place.

IoReadPartitionTableEx est en mesure de lire les informations de table de partition à partir de disques GPT (GUID Partition Table), ainsi que les disques MBR (Master Boot Record) hérités. Les pilotes de périphérique de disque appellent cette routine pendant l’initialisation du pilote.

Il incombe à l’appelant de libérer le PartitionBuffer qui a été alloué par cette routine avec ExFreePool.

Notez que les pilotes de disque retournent et définissent également des informations de partition en réponse aux requêtes IRP_MJ_DEVICE_CONTROL avec les codes de contrôle d’E/S suivants :

IOCTL_DISK_GET_PARTITION_INFO_EX
IOCTL_DISK_SET_PARTITION_INFO_EX
IOCTL_DISK_GET_DRIVE_LAYOUT_EX
IOCTL_DISK_SET_DRIVE_LAYOUT_EX
IOCTL_DISK_GET_DRIVE_GEOMETRY

Exigences

Exigence	Valeur
plateforme cible	Universel
d’en-tête	ntddk.h (include Ntddk.h)
bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
règles de conformité DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)