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 コード ハンドラーの呼び出し」を参照してください。
 
INF ファイル形式の詳細については、「 INF ファイルのセクションとディレクティブ」を参照してください。

要件

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

こちらもご覧ください

DIF_INSTALLINTERFACES

SetupDiCreateDeviceInterface