Función IoReadPartitionTableEx (ntddk.h)
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) |
Consulte también
IOCTL_DISK_GET_DRIVE_LAYOUT_EX
IOCTL_DISK_GET_PARTITION_INFO_EX
IOCTL_DISK_SET_DRIVE_LAYOUT_EX