次の方法で共有

SetupDiSetSelectedDriverA 関数 (setupapi.h)

  • [アーティクル]

SetupDiSetSelectedDriver 関数は、デバイス情報要素の選択されたドライバー、またはデバイス情報セットの選択したクラス ドライバーを設定またはリセットします。

構文

WINSETUPAPI BOOL SetupDiSetSelectedDriverA(
  [in]      HDEVINFO           DeviceInfoSet,
  [in, out] PSP_DEVINFO_DATA   DeviceInfoData,
  [in, out] PSP_DRVINFO_DATA_A DriverInfoData
);

パラメーター

[in] DeviceInfoSet

デバイス情報要素またはデバイス情報セットのドライバーを選択するドライバーの一覧を含む、デバイス情報セットのハンドル。

[in, out] DeviceInfoData

DeviceInfoSet内のデバイス情報要素を指定する SP_DEVINFO_DATA 構造体 ポインター。 このパラメーターは省略可能であり、NULLできます。 このパラメーターを指定した場合、SetupDiSetSelectedDriver 、指定したデバイスの選択したドライバーを設定またはリセットします。 このパラメーターが null、SetupDiSetSelectedDriver セット、またはリセット 場合は、DeviceInfoSet選択したクラス ドライバー。

[in, out] DriverInfoData

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

DriverInfoData の場合。予約 が NULL、呼び出し元は、指定されたパラメーター (DriverType、Description、および ProviderName) を持つドライバー ノード 検索を要求しています。 一致が見つかった場合は、そのドライバー ノードが選択されます。 予約済み フィールドは、一致が見つかった実際のドライバー ノードを反映するように出力時に更新されます。 一致するものが見つからない場合、関数は失敗し、GetLastError 呼び出すとERROR_INVALID_PARAMETERが返されます。

戻り値

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

備考

SetupDiSetSelectedDriver の呼び出し元が Administrators グループのメンバーである場合、デバイスのクラスは、2 つのクラスが異なる場合、選択したドライバーのクラスに設定されます。

DriverInfoData が NULL場合、SetupDiSetSelectedDriver 選択したドライバーがリセット。 その結果、選択されたドライバーはありません。

手記

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

必要条件

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

関連項目

SetupDiGetSelectedDriver の