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) ディスクからパーティションテーブル情報を読み取ります。ディスクデバイスドライバーは、ドライバーの初期化中にこのルーチンを呼び出します。

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

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

要件	価値
ターゲットプラットフォームの	万国
ヘッダー	ntddk.h (Ntddk.h を含む)
ライブラリ	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則をする	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)