Funzione IoReadPartitionTableEx (ntddk.h)

Articolo
02/07/2025

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 di settore. In caso contrario, restituisce un valore di stato di errore e imposta il puntatore PartitionBuffer su NULL.

Osservazioni

i IoReadPartitionTableEx devono essere usati 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 della tabella di partizione da dischi GPT (GUID Partition Table) e dischi MBR (Master Boot Record) legacy. I driver di dispositivo del disco chiamano questa routine durante l'inizializzazione del driver.

È responsabilità del chiamante deallocare il 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

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)