Funzione IoWritePartitionTableEx (ntddk.h)
Il IoWritePartitionTableEx routine scrive tabelle di partizione dalle voci nel buffer dell'elenco di partizioni per ogni partizione sul disco rappresentato dall'oggetto dispositivo specificato.
Sintassi
NTSTATUS IoWritePartitionTableEx(
[in] PDEVICE_OBJECT DeviceObject,
_DRIVE_LAYOUT_INFORMATION_EX *DriveLayout
);
Parametri
[in] DeviceObject
Puntatore all'oggetto dispositivo che rappresenta il disco le cui tabelle di partizione devono essere scritte.
DriveLayout
Puntatore al buffer di layout dell'unità che contiene le voci dell'elenco di partizioni. Per informazioni più dettagliate, vedere DRIVE_LAYOUT_INFORMATION_EX.
Valore restituito
IoWritePartitionTableEx restituisce un codice di stato di STATUS_SUCCESS se tutte le scritture sono state completate senza errori. In caso di errore, i codici di errore restituiti da IoWritePartitionTableEx possono includere, ma non solo, l'elenco seguente:
| Codice restituito | Descrizione |
|---|---|
| STATUS_DEVICE_NOT_READY | Indica un errore durante la lettura della geometria del disco corretta. |
| STATUS_INSUFFICIENT_RESOURCES | Indica un errore di allocazione delle risorse necessarie, ad esempio memoria heap, IRP e così via. |
| STATUS_UNSUCCESSFUL | Indica che il settore zero non ha la firma del disco MBR prevista. |
Osservazioni
IoWritePartitionTableEx sostituisce la routine obsoleta IoWritePartitionTable. A differenza della routine precedente, può scrivere in tabelle di partizione GUID e tabelle di partizione del record di avvio master.
i IoWritePartitionTableEx devono essere usati solo dai driver del disco. Altri driver devono usare invece la richiesta di I/O del disco IOCTL_DISK_SET_DRIVE_LAYOUT_EX.
Quando un driver di dispositivo disco riceve una richiesta di IRP_MJ_DEVICE_CONTROL per impostare il tipo di partizione in una voce della tabella di partizione o per ripartizionare il disco, deve chiamare IoWritePartitionTableEx. La richiesta di controllo del dispositivo viene in genere rilasciata dall'utilità di formato, che esegue funzioni di controllo di I/O sulle partizioni e i dischi del computer.
Per reimpostare un tipo di partizione, il driver passa un puntatore all'oggetto dispositivo, che rappresenta il disco fisico e il numero della partizione associata all'oggetto dispositivo aperto dall'utilità di formato. Quando un disco deve essere ripartizionato in modo dinamico, il driver del disco deve eliminare il set di oggetti dispositivo che rappresenta le partizioni del disco correnti e creare un nuovo set di oggetti dispositivo che rappresentano le nuove partizioni sul disco.
Per creare o eliminare partizioni, è necessario ottenere una descrizione completa del sistema tramite una chiamata a IoReadPartitionTableEx. La struttura del layout dell'unità può essere modificata dall'utilità di formato di sistema per riflettere una nuova configurazione del disco.
IoWritePartitionTableEx è sincrono. Deve essere chiamato dalla routine Dispatch del driver del disco o da un thread del driver. Pertanto, tutti i thread utente e file system devono essere preparati a entrare in uno stato di attesa durante l'emissione della richiesta di controllo del dispositivo per reimpostare i tipi di partizione per il dispositivo.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| intestazione | ntddk.h (include Ntddk.h) |
| libreria | NtosKrnl.lib |
| dll | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| regole di conformità DDI | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |