SetupDiInstallDeviceInterfaces 関数 (setupapi.h)
SetupDiInstallDeviceInterfaces 関数は、DIF_INSTALLINTERFACESインストール要求の既定のハンドラーです。
構文
WINSETUPAPI BOOL SetupDiInstallDeviceInterfaces(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVINFO_DATA DeviceInfoData
);
パラメーター
[in] DeviceInfoSet
インターフェイスをインストールする デバイス を表すデバイス情報要素を含むデバイス情報セットへのポインター。 デバイス情報セットには、ローカル システムの要素のみを含める必要があります。
[in] DeviceInfoData
DeviceInfoSet のデバイス情報要素を指定するSP_DEVINFO_DATA構造体へのポインター。
戻り値
関数がエラーなしで完了した場合、SetupDiInstallDeviceInterfaces は TRUE を返します。 関数がエラーで完了した場合、 FALSE が返され、 GetLastError を呼び出すことによってエラーのエラー コードを取得できます。
注釈
SetupDiInstallDeviceInterfaces は、DDInstall 内の各 AddInterface エントリを処理します。デバイス INF ファイルの [インターフェイス] セクションで、SetupDiCreateDeviceInterface を呼び出して各インターフェイスを作成します。
SetupDiInstallDeviceInterfaces の呼び出し元は、Administrators グループのメンバーである必要があります。
メモSetupDiInstallDeviceInterfaces が既定のデバイス インターフェイスのインストール操作を完了した後、クラス インストーラーがデバイス インターフェイスのインストール操作を実行する必要がある状況でのみ、クラス インストーラーのみが SetupDiInstallDeviceInterfaces を呼び出す必要があります。 このような状況では、インストーラーがDIF_INSTALLINTERFACES要求を処理するときに、クラス インストーラーが SetupDiInstallDeviceInterfaces を直接呼び出す必要があります。 既定のハンドラーの呼び出しの詳細については、「 既定の DIF コード ハンドラーの呼び出し」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Microsoft Windows 2000 以降のバージョンの Windows で使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | setupapi.h (Setupapi.h を含む) |
| Library | Setupapi.lib |
| [DLL] | Setupapi.dll |