Fonction IoReadPartitionTableEx (ntddk.h)

Article
02/26/2024

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. En cas de réussite, IoReadPartitionTableEx alloue la mémoire de cette mémoire tampon à partir d’un pool non paginé et retourne les informations de disposition de lecteur qu’il contient.

Valeur retournée

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

Remarques

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

IoReadPartitionTableEx peut lire les informations de table de partition à partir de disques GPT (GUID Partition Table) ainsi que de disques MBR (Master Boot Record) hérités. Les pilotes de périphériques de disque appellent cette routine lors de 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 à IRP_MJ_DEVICE_CONTROL demandes 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

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
En-tête	ntddk.h (incluez Ntddk.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Règles de conformité DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)