Partager via


Fonction IoReadPartitionTableEx (ntddk.h)

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)

Voir aussi

DRIVE_LAYOUT_INFORMATION_EX

IOCTL_DISK_GET_DRIVE_GEOMETRY

IOCTL_DISK_GET_DRIVE_LAYOUT_EX

IOCTL_DISK_GET_PARTITION_INFO_EX

IOCTL_DISK_SET_DRIVE_LAYOUT_EX

IOCTL_DISK_SET_PARTITION_INFO_EX

IoSetPartitionInformation

IoWritePartitionTableEx

PARTITION_INFORMATION_EX