Función IoReadPartitionTableEx (ntddk.h)

Artículo
02/29/2024

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 para el disco cuyas particiones se van a leer.

DriveLayout

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

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.

Comentarios

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

IoReadPartitionTableEx puede leer la información de la tabla de particiones de los discos de tabla de particiones GUID (GPT), así como los discos heredados del 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	Value
Plataforma de destino	Universal
Encabezado	ntddk.h (incluya Ntddk.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Reglas de cumplimiento de DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)