SetupDiEnumDeviceInfo 関数 (setupapi.h)
SetupDiEnumDeviceInfo 関数は、デバイス情報セット内のデバイス情報要素を指定するSP_DEVINFO_DATA構造体を返します。
構文
WINSETUPAPI BOOL SetupDiEnumDeviceInfo(
[in] HDEVINFO DeviceInfoSet,
[in] DWORD MemberIndex,
[out] PSP_DEVINFO_DATA DeviceInfoData
);
パラメーター
[in] DeviceInfoSet
デバイス情報要素を表すSP_DEVINFO_DATA構造体を返すデバイス情報セットへのハンドル。
[in] MemberIndex
取得するデバイス情報要素の 0 から始まるインデックス。
[out] DeviceInfoData
列挙されたデバイス情報要素に関する情報を受け取る SP_DEVINFO_DATA 構造体へのポインター。 呼び出し元は DeviceInfoData を設定する必要があります。cbSize から に変更します sizeof(SP_DEVINFO_DATA)。
戻り値
成功した場合、関数は TRUE を 返します。 それ以外の場合は FALSE を 返し、ログに記録されたエラーを GetLastError の呼び出しで取得できます。
解説
この関数の呼び出しを繰り返し実行すると、別のデバイスのデバイス情報要素が返されます。 この関数を繰り返し呼び出して、デバイス情報セット内のすべてのデバイスに関する情報を取得できます。
デバイス情報要素を列挙するには、インストーラーは最初に、MemberIndex パラメーターを 0 に設定して SetupDiEnumDeviceInfo を呼び出す必要があります。 その後、インストーラーは MemberIndex をインクリメントし、値がなくなったまで SetupDiEnumDeviceInfo を呼び出す必要があります (関数は失敗し、 GetLastError の呼び出しは ERROR_NO_MORE_ITEMSを返します)。
SetupDiEnumDeviceInterfaces を呼び出して、デバイス インターフェイス要素 (デバイス情報要素に対する) のコンテキスト構造を取得します。
要件
| サポートされている最小のクライアント | Microsoft Windows 2000 以降のバージョンの Windows で使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | setupapi.h (Setupapi.h を含む) |
| Library | Setupapi.lib |
| [DLL] | Setupapi.dll |
| API セット | ext-ms-win-setupapi-classinstallers-l1-1-0 (Windows 8 で導入) |