Share via

SetupDiSelectOEMDrv 関数 (setupapi.h)

  • [アーティクル]

SetupDiSelectOEMDrv 関数は、ユーザーが指定した OEM パスを使用するデバイス情報セットまたは特定のデバイス情報要素のドライバーを選択します。

構文

WINSETUPAPI BOOL SetupDiSelectOEMDrv(
  [in, optional] HWND             hwndParent,
  [in]           HDEVINFO         DeviceInfoSet,
  [in, out]      PSP_DEVINFO_DATA DeviceInfoData
);

パラメーター

[in, optional] hwndParent

この関数の処理中に作成されたダイアログの親となるウィンドウ ハンドル。 このパラメーターは、指定されたデバイス情報セットまたはエレメントのインストール・パラメーター・ブロック内の hwndParent フィールドをオーバーライドするために使用できます。

[in] DeviceInfoSet

ドライバーを選択する デバイス情報セット へのハンドル。

[in, out] DeviceInfoData

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

戻り値

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

解説

SetupDiSelectOEMDrv は、主にそのコンピューターにデバイスをインストールする前に、ローカル コンピューター上のデバイスの OEM ドライバーを選択するように設計されています。 デバイス情報セットがリモート コンピューター用の場合、 SetupDiSelectOEMDrv は失敗しませんが、その後、デバイス情報セットを DIF_Xxx インストール要求またはリモート コンピューターでの操作をサポートしない SetupDiXxx 関数で使用できないため、限定的な使用になります。 特に、デバイス情報セットは、リモート コンピューターにデバイスをインストールするためのDIF_INSTALLDEVICEインストール要求の入力として使用できません。

SetupDiSelectOEMDrv は 、OEM パスの入力をユーザーに求め、クラス インストーラーを呼び出して OEM パスからドライバーを選択します。

要件

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

関連項目

SetupDiAskForOEMDisk