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 を呼び出して、デバイス インターフェイス要素 (デバイス情報要素) のコンテキスト構造を取得します。
SetupDiEnumDeviceInfo の使用例は、SetupDiGetClassDevsW を文書化したページで入手できます。
Requirements
| Requirement | 価値 |
|---|---|
| サポートされる最小クライアント | 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 で導入) |
こちらも参照ください
SetupDiDeleteDeviceInfo の
SetupDiEnumDeviceInterfaces の