IoGetConfigurationInformation 関数 (ntifs.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 アドレス範囲のいずれかを要求したかどうかを示す値も含まれています。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 |
| 対象プラットフォーム | ユニバーサル |
| Header | ntifs.h (Ntddk.h、Ntifs.h を含む) |
| Library | NtosKrnl.lib |
| [DLL] | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI コンプライアンス規則 | HwStorPortProhibitedDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm) |