Función IoWritePartitionTable (ntddk.h)
La rutina IoWritePartitionTable está obsoleta y solo se proporciona para admitir controladores existentes. Los nuevos controladores deben usar IoWritePartitionTableEx.
IoWritePartitionTable escribe tablas de partición de las entradas del búfer de lista de particiones para cada partición del disco representado por el objeto de dispositivo especificado.
Sintaxis
NTSTATUS IoWritePartitionTable(
[in] PDEVICE_OBJECT DeviceObject,
[in] ULONG SectorSize,
[in] ULONG SectorsPerTrack,
[in] ULONG NumberOfHeads,
[in] _DRIVE_LAYOUT_INFORMATION *PartitionBuffer
);
Parámetros
[in] DeviceObject
Puntero al objeto de dispositivo que representa el disco cuyas tablas de partición se van a escribir.
[in] SectorSize
Especifica el tamaño en bytes de sectores del dispositivo.
[in] SectorsPerTrack
Especifica el tamaño de la pista en el dispositivo.
[in] NumberOfHeads
Especifica el número de pistas por cilindro.
[in] PartitionBuffer
Puntero al búfer de diseño de unidad que contiene las entradas de la lista de particiones. Para obtener información más detallada, consulte DRIVE_LAYOUT_INFORMATION.
Valor devuelto
IoWritePartitionTablo devuelve un código de estado de STATUS_SUCCESS si todas las escrituras se completaron sin errores. En caso de error, los códigos de error devueltos por IoWritePartitionTable pueden incluir, pero no se limitan a, la siguiente lista:
| Código devuelto | Descripción |
|---|---|
| STATUS_DEVICE_NOT_READY | Indica un error al leer la geometría de disco correcta. |
| STATUS_INSUFFICIENT_RESOURCES | Indica un error al asignar los recursos necesarios (por ejemplo, memoria del montón, IRP, etc.). |
| STATUS_UNSUCCESSFUL | Indica que el sector cero no tenía la firma de disco MBR esperada. |
Comentarios
Los controladores de disco solo deben usar IoWritePartitionTable. Otros controladores deben usar la solicitud de E/S de disco IOCTL_DISK_SET_DRIVE_LAYOUT en su lugar.
Se llama a IoWritePartitionTable cuando se solicita un controlador de dispositivo de disco para establecer el tipo de partición en una entrada de tabla de particiones o para volver a particionar el disco mediante una solicitud de IRP_MJ_DEVICE_CONTROL. Por lo general, la utilidad de formato emite la solicitud de control de dispositivos, que realiza funciones de control de E/S en las particiones y los discos de la máquina.
Para restablecer un tipo de partición, el controlador pasa un puntero al objeto de dispositivo que representa el disco físico y el número de la partición asociada al objeto de dispositivo que la utilidad de formato tiene abierta. Cuando un disco se va a volver a particionar dinámicamente, el controlador de disco debe anular su conjunto de objetos de dispositivo que representan las particiones de disco actuales y crear un nuevo conjunto de objetos de dispositivo que representen las nuevas particiones en el disco.
Las aplicaciones que crean y eliminan particiones y requieren descripciones completas del sistema deben llamar a IoReadPartitionTable con ReturnRecognizedPartitions establecido en FALSE. La utilidad de formato del sistema puede modificar la estructura de diseño de la unidad para reflejar una nueva configuración del disco.
IoWritePartitionTable es sincrónico. Debe llamarlo la rutina dispatch del controlador de disco o mediante un subproceso de controlador. Por lo tanto, todos los subprocesos del sistema de archivos y de usuario deben estar preparados para entrar en un estado de espera al emitir la solicitud de control de dispositivo para restablecer los tipos de partición del dispositivo.
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 | HwStorPortProhibitedDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm) |