IoReadPartitionTableEx 関数 (ntddk.h)

IoReadPartitionTableEx ルーチンは、指定されたセクターサイズを持つディスク上のパーティションの一覧を読み取り、認識された各パーティションのパーティション一覧にエントリを作成します。

構文

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

[in] DeviceObject

パーティションを読み取るディスクのデバイスオブジェクトへのポインター。

DriveLayout

初期化されていないアドレスへのポインター。成功した場合、 IoReadPartitionTableEx は非ページプールからこのバッファーのメモリを割り当て、その中のドライブレイアウト情報を返します。

このルーチンは、少なくとも 1 つのセクターテーブルが読み取られた場合STATUS_SUCCESSの値を返します。それ以外の場合は、エラー状態の値を返し、 PartitionBuffer のポインターを NULL に設定 します。

IoReadPartitionTableEx は、ディスクドライバーでのみ使用する必要があります。他のドライバーでは、代わりに IOCTL_DISK_GET_DRIVE_LAYOUT_EX ディスク I/O 要求を使用する必要があります。

IoReadPartitionTableEx は、GUID パーティションテーブル (GPT) ディスクおよび従来のマスターブートレコード (MBR) ディスクからパーティションテーブル情報を読み取ります。ディスクデバイスドライバーは、ドライバーの初期化中にこのルーチンを呼び出します。

呼び出し元は、ExFreePool でこのルーチンによって割り当てられた PartitionBuffer の割り当てを解除する必要があります。

また、ディスクドライバーは、次の I/O 制御コードを使用して、IRP_MJ_DEVICE_CONTROL要求に応答してパーティション情報を返し、設定します。

要件	値
対象プラットフォーム	ユニバーサル
Header	ntddk.h (Ntddk.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)