Funzione IoReadPartitionTableEx (ntddk.h)
La routine IoReadPartitionTableEx legge un elenco di partizioni in un disco con dimensioni di settore specificate e crea una voce nell'elenco di partizioni per ogni partizione riconosciuta.
Sintassi
NTSTATUS IoReadPartitionTableEx(
[in] PDEVICE_OBJECT DeviceObject,
_DRIVE_LAYOUT_INFORMATION_EX **DriveLayout
);
Parametri
[in] DeviceObject
Puntatore all'oggetto dispositivo per il disco le cui partizioni devono essere lette.
DriveLayout
Puntatore a un indirizzo non inizializzato. In caso di esito positivo, IoReadPartitionTableEx alloca la memoria per questo buffer dal pool non di paging e restituisce le informazioni sul layout dell'unità.
Valore restituito
Questa routine restituisce un valore di STATUS_SUCCESS se è stata letta almeno una tabella del settore. In caso contrario, restituisce un valore di stato di errore e imposta il puntatore in PartitionBuffer su NULL.
Commenti
IoReadPartitionTableEx deve essere usato solo dai driver del disco. Altri driver devono usare invece la richiesta di I/O del disco IOCTL_DISK_GET_DRIVE_LAYOUT_EX .
IoReadPartitionTableEx è in grado di leggere le informazioni sulle tabelle di partizione dai dischi GPT (GUID Partition Table), nonché dai dischi MBR (Master Boot Record) legacy. I driver di dispositivo su disco chiamano questa routine durante l'inizializzazione del driver.
È responsabilità del chiamante deallocare partitionBuffer allocato da questa routine con ExFreePool.
Si noti che anche i driver del disco restituiscono e impostano le informazioni sulla partizione in risposta alle richieste di IRP_MJ_DEVICE_CONTROL con i codici di controllo di I/O seguenti:
- 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
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 | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |
Vedi anche
IOCTL_DISK_GET_DRIVE_LAYOUT_EX
IOCTL_DISK_GET_PARTITION_INFO_EX
IOCTL_DISK_SET_DRIVE_LAYOUT_EX