IoGetConfigurationInformation 関数 (ntddk.h)
IoGetConfigurationInformation ルーチンは、I/O マネージャーのグローバル構成情報構造体へのポインターを返します。この構造体には、読み込まれるドライバーによってそれらを表すデバイス オブジェクトが作成された物理ディスク、フロッピー、CD-ROM、テープ、SCSI HBA、シリアル、および並列デバイスの数の現在の値が含まれています。
構文
PCONFIGURATION_INFORMATION IoGetConfigurationInformation();
戻り値
IoGetConfigurationInformation は 、CONFIGURATION_INFORMATION 構造体へのポインターを返します。
注釈
特定の種類のデバイス ドライバーでは、構成情報構造体の値を使用して、各ドライバーがデバイス オブジェクトを作成するときに、適切な数字のサフィックスを持つデバイス オブジェクト名を構築できます。 デバイス オブジェクト名の数字サフィックスは 0 から始まるカウントですが、構成情報構造で保持されるカウントは、既に作成されている特定の種類のデバイス オブジェクトの数を表します。 つまり、構成情報の数は 1 から始まります。
IoGetConfigurationInformation を呼び出すドライバーは、物理デバイスを表すデバイス オブジェクトを作成するときに、この構造体内のデバイスの種類の数を増やす必要があります。
システム提供の SCSI ポート ドライバーは、コンピューターに存在する SCSI HBA の数を提供します。 SCSI クラス ドライバーは、この値を読み取って、クラス ドライバーの種類の接続されたデバイスで SCSI バスを制御できる HBA 固有のミニポート ドライバーの数を決定できます。
構成情報構造体には、既に読み込まれたドライバーが "AT" ディスク I/O アドレス範囲のいずれかを要求したかどうかを示す値も含まれています。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| Header | ntddk.h (Ntddk.h、Ntifs.h を含む) |
| Library | NtosKrnl.lib |
| [DLL] | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI コンプライアンス規則 | HwStorPortProhibitedDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm) |