Condividi tramite


Funzione IoWritePartitionTable (ntddk.h)

La routine IoWritePartitionTable è obsoleta e viene fornita solo per supportare i driver esistenti. I nuovi driver devono usare IoWritePartitionTableEx.

IoWritePartitionTable scrive tabelle di partizione dalle voci nel buffer dell'elenco di partizioni per ogni partizione nel disco rappresentato dall'oggetto dispositivo specificato.

Sintassi

NTSTATUS IoWritePartitionTable(
  [in] PDEVICE_OBJECT            DeviceObject,
  [in] ULONG                     SectorSize,
  [in] ULONG                     SectorsPerTrack,
  [in] ULONG                     NumberOfHeads,
  [in] _DRIVE_LAYOUT_INFORMATION *PartitionBuffer
);

Parametri

[in] DeviceObject

Puntatore all'oggetto dispositivo che rappresenta il disco le cui tabelle di partizione devono essere scritte.

[in] SectorSize

Specifica le dimensioni in byte di settori nel dispositivo.

[in] SectorsPerTrack

Specifica le dimensioni della traccia nel dispositivo.

[in] NumberOfHeads

Specifica il numero di tracce per ogni cilindro.

[in] PartitionBuffer

Puntatore al buffer di layout dell'unità contenente le voci dell'elenco di partizioni. Per informazioni più dettagliate, vedere DRIVE_LAYOUT_INFORMATION.

Valore restituito

IoWritePartitionTablo 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 IoWritePartitionTable potrebbero includere, ma non sono limitati a, 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.

Commenti

IoWritePartitionTable deve essere usato solo dai driver del disco. Altri driver devono usare invece la richiesta di I/O del disco IOCTL_DISK_SET_DRIVE_LAYOUT .

IoWritePartitionTable viene chiamato quando viene richiesto a un driver di dispositivo disco di impostare il tipo di partizione in una voce di tabella di partizione o per suddividere il disco da una richiesta di IRP_MJ_DEVICE_CONTROL. La richiesta di controllo del dispositivo viene generalmente rilasciata dall'utilità di formato, che esegue funzioni di controllo I/O nelle partizioni e nei 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 ripartito in modo dinamico, il driver del disco deve eliminare il set di oggetti dispositivo che rappresentano le partizioni del disco correnti e creare un nuovo set di oggetti dispositivo che rappresentano le nuove partizioni sul disco.

Le applicazioni che creano ed eliminano partizioni e richiedono descrizioni complete del sistema devono chiamare IoReadPartitionTable con ReturnRecognizedPartitions impostata su FALSE. La struttura del layout dell'unità può essere modificata dall'utilità di formato di sistema per riflettere una nuova configurazione del disco.

IoWritePartitionTable è sincrona. 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 per immettere uno stato di attesa durante l'emissione della richiesta di controllo del dispositivo per reimpostare i tipi di partizione per il dispositivo.

Requisiti

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 HwStorPortProhibitedDDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm)

Vedi anche

IoCreateDevice

IoReadPartitionTable

IoSetPartitionInformation