Funzione IoReadPartitionTableEx (ntddk.h)

Articolo
02/26/2024

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)