SetupDiCreateDeviceInfoList 関数 (setupapi.h)

SetupDiCreateDeviceInfoList 関数は、空のデバイス情報セットを作成し、必要に応じて、そのセットをデバイス セットアップ クラスと最上位ウィンドウに関連付けます。

構文

WINSETUPAPI HDEVINFO SetupDiCreateDeviceInfoList(
  [in, optional] const GUID *ClassGuid,
  [in, optional] HWND       hwndParent
);

パラメーター

[in, optional] ClassGuid

新しく作成されたデバイス情報セットに関連付けるデバイス セットアップ クラスの GUID へのポインター。 このパラメーターを指定すると、このクラスのデバイスのみをこのデバイス情報セットに含めることができます。 このパラメーターが NULL に設定されている場合、デバイス情報セットは特定のデバイス セットアップ クラスに関連付けられません。

[in, optional] hwndParent

デバイス固有以外のアクション (グローバル クラス ドライバー リストを使用する [デバイスの選択] ダイアログ ボックスなど) に関連するすべてのユーザー インターフェイスに使用する最上位ウィンドウへのハンドル。 このハンドルは省略可能であり、 NULL にすることができます。 特定の最上位ウィンドウが不要な場合は、 hwndParent を NULL に設定 します。

戻り値

関数は、成功した場合に空のデバイス情報セットにハンドルを返します。 それ以外の場合は、 INVALID_HANDLE_VALUEを返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

この関数の呼び出し元は、 SetupDiDestroyDeviceInfoList を呼び出して不要になった場合に、返されたデバイス情報セットを削除する必要があります。

リモート コンピューターのデバイス情報リストを作成するには、 SetupDiCreateDeviceInfoListEx を使用します。

要件

サポートされている最小のクライアント	Microsoft Windows 2000 以降のバージョンの Windows で使用できます。
対象プラットフォーム	デスクトップ
Header	setupapi.h (Setupapi.h を含む)
Library	Setupapi.lib
[DLL]	Setupapi.dll
API セット	ext-ms-win-setupapi-classinstallers-l1-1-1 (Windows 8.1で導入)

関連項目

SetupDiCreateDeviceInfoListEx

SetupDiDestroyDeviceInfoList

SetupDiGetClassDevs

SetupDiGetDeviceInfoListClass