次の方法で共有

SetupDiGetClassInstallParamsA 関数 (setupapi.h)

  • [アーティクル]

SetupDiGetClassInstallParams 関数は、デバイス情報セットまたは特定のデバイス情報要素のクラス インストール パラメーターを取得します。

構文

WINSETUPAPI BOOL SetupDiGetClassInstallParamsA(
  [in]            HDEVINFO                DeviceInfoSet,
  [in, optional]  PSP_DEVINFO_DATA        DeviceInfoData,
  [out, optional] PSP_CLASSINSTALL_HEADER ClassInstallParams,
  [in]            DWORD                   ClassInstallParamsSize,
  [out, optional] PDWORD                  RequiredSize
);

パラメーター

[in] DeviceInfoSet

取得するクラス インストール パラメーターを含む デバイス情報セットへのハンドル。

[in, optional] DeviceInfoData

DeviceInfoSetでデバイス情報要素を指定した SP_DEVINFO_DATA 構造体 ポインター。 このパラメーターは省略可能であり、NULLできます。 このパラメーターを指定すると、SetupDiGetClassInstallParams 指定したデバイスのクラス インストール パラメーターが取得されます。 このパラメーターが NULL場合、SetupDiGetClassInstallParams は、DeviceInfoSetに関連付けられているグローバル クラス ドライバー リストのクラス インストール パラメーター 取得します。

[out, optional] ClassInstallParams

SP_CLASSINSTALL_HEADER 構造体を含むバッファーへのポインター。 この構造体には、入力時に cbSize メンバーが sizeof(SP_CLASSINSTALL_HEADER) に設定されている必要があります。または、バッファーが無効と見なされます。 出力時に、InstallFunction メンバーには、取得するクラス インストール パラメーターに デバイス インストール関数コードが入力されます。 バッファーが十分な大きさの場合は、関数コードに固有のクラス インストール パラメーター構造も受け取ります。 ClassInstallParams 指定されていない場合、ClassInstallParamsSize は 0 である必要があります。

[in] ClassInstallParamsSize

ClassInstallParams バッファーのサイズ (バイト単位)。 バッファーを指定する場合は、sizeof(SP_CLASSINSTALL_HEADER) と同じ大きさにする必要があります。 バッファーが指定されていない場合、ClassInstallParamsSize は 0である必要があります。

[out, optional] RequiredSize

クラスのインストール パラメーターを格納するために必要なバイト数を受け取る DWORD 型の変数へのポインター。 このパラメーターは省略可能であり、NULLできます。

戻り値

この関数は、成功した場合 TRUE を返します。 それ以外の場合は、FALSE を返し、ログに記録されたエラーを GetLastError呼び出して取得できます。

備考

クラス インストール パラメーターは、ClassInstallParams バッファーの先頭にある ClassInstallHeader フィールドに格納されている特定の デバイス インストール関数コード に固有です。

手記

setupapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SetupDiGetClassInstallParams を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Microsoft Windows 2000 以降のバージョンの Windows で使用できます。
ターゲット プラットフォーム の デスクトップ
ヘッダー setupapi.h (Setupapi.h を含む)
ライブラリ Setupapi.lib

関連項目

SetupDiSetClassInstallParams の