Fungsi IoReadPartitionTableEx (ntddk.h)

Artikel
02/29/2024

Rutinitas IoReadPartitionTableEx membaca daftar partisi pada disk yang memiliki ukuran sektor tertentu dan membuat entri dalam daftar partisi untuk setiap partisi yang dikenali.

Sintaks

NTSTATUS IoReadPartitionTableEx(
  [in] PDEVICE_OBJECT               DeviceObject,
       _DRIVE_LAYOUT_INFORMATION_EX **DriveLayout
);

Parameter

[in] DeviceObject

Arahkan ke objek perangkat untuk disk yang partisinya akan dibaca.

DriveLayout

Penunjuk ke alamat yang tidak diinisialisasi. Jika berhasil, IoReadPartitionTableEx mengalokasikan memori untuk buffer ini dari kumpulan yang tidak disebarkan dan mengembalikan informasi tata letak drive di dalamnya.

Nilai kembali

Rutinitas ini mengembalikan nilai STATUS_SUCCESS jika setidaknya satu tabel sektor dibaca. Jika tidak, ia mengembalikan nilai status kesalahan dan mengatur penunjuk di PartitionBuffer ke NULL.

Keterangan

IoReadPartitionTableEx hanya boleh digunakan oleh driver disk. Driver lain harus menggunakan permintaan I/O disk IOCTL_DISK_GET_DRIVE_LAYOUT_EX sebagai gantinya.

IoReadPartitionTableEx dapat membaca informasi tabel partisi dari disk GUID Partition Table (GPT) serta disk Master Boot Record (MBR) warisan. Driver perangkat disk memanggil rutinitas ini selama inisialisasi driver.

Pemanggil bertanggung jawab untuk membatalkan alokasi PartitionBuffer yang dialokasikan oleh rutinitas ini dengan ExFreePool.

Perhatikan bahwa driver disk juga mengembalikan dan mengatur informasi partisi sebagai respons terhadap permintaan IRP_MJ_DEVICE_CONTROL dengan kode kontrol I/O berikut:

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

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Header	ntddk.h (termasuk Ntddk.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Aturan kepatuhan DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)