Función IoReadPartitionTableEx (ntddk.h)

Artículo
02/07/2025

La rutina IoReadPartitionTableEx lee una lista de particiones en un disco que tiene un tamaño de sector especificado y crea una entrada en la lista de particiones para cada partición reconocida.

Sintaxis

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

Parámetros

[in] DeviceObject

Puntero al objeto de dispositivo del disco cuyas particiones se van a leer.

DriveLayout

Puntero a una dirección sin inicializar. Si se ejecuta correctamente, IoReadPartitionTableEx asigna la memoria de este búfer del grupo no paginado y devuelve la información de diseño de unidad en él.

Valor devuelto

Esta rutina devuelve un valor de STATUS_SUCCESS si se leyó al menos una tabla de sector. De lo contrario, devuelve un valor de estado de error y establece el puntero en PartitionBuffer en NULL.

Observaciones

IoReadPartitionTableEx solo los controladores de disco deben usar. Otros controladores deben usar la solicitud de E/S de disco IOCTL_DISK_GET_DRIVE_LAYOUT_EX en su lugar.

ioReadPartitionTableEx puede leer información de tabla de particiones de discos de tabla de particiones GUID (GPT), así como discos heredados de registro de arranque maestro (MBR). Los controladores de dispositivo de disco llaman a esta rutina durante la inicialización del controlador.

Es responsabilidad del autor de la llamada desasignar el PartitionBuffer asignado por esta rutina con ExFreePool.

Tenga en cuenta que los controladores de disco también devuelven y establecen información de partición en respuesta a IRP_MJ_DEVICE_CONTROL solicitudes con los siguientes códigos de control de E/S:

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

Requisitos

Requisito	Valor
de la plataforma de destino de	Universal
encabezado de	ntddk.h (incluya Ntddk.h)
biblioteca de	NtosKrnl.lib
DLL de	NtosKrnl.exe
irQL	PASSIVE_LEVEL
reglas de cumplimiento de DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)