SetupDiSetDeviceInterfaceDefault 関数 (setupapi.h)

SetupDiSetDeviceInterfaceDefault 関数は、デバイス インターフェイスをデバイス インターフェイス クラスの既定のインターフェイスとして設定します。

構文

WINSETUPAPI BOOL SetupDiSetDeviceInterfaceDefault(
  [in]      HDEVINFO                  DeviceInfoSet,
  [in, out] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
  [in]      DWORD                     Flags,
            PVOID                     Reserved
);

パラメーター

[in] DeviceInfoSet

デバイス インターフェイス クラスの既定値として設定するデバイス インターフェイスを含むデバイス 情報セット へのハンドル。

[in, out] DeviceInterfaceData

DeviceInfoSet のデバイス インターフェイスを指定するSP_DEVICE_INTERFACE_DATA構造体へのポインター。

[in] Flags

使用されません。0 にする必要があります。

Reserved

今後使用するために予約されている は NULL である必要があります。

戻り値

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

注釈

呼び出し元には、デバイス インターフェイス クラスの既定のインターフェイスを設定するための管理者特権が必要です。 ただし、要求された既定のインターフェイスが現在設定されている既定のインターフェイスと同じ場合、呼び出し元に管理者特権があるかどうかに関係なく、関数は TRUE を 返します。

関数は、指定したデバイス インターフェイスをデバイス クラスの既定値として正常に設定した場合、指定されたSP_DEVICE_INTERFACE_DATA構造体の Flags メンバーを更新します。

SetupDiGetClassDevs を呼び出して、デバイス インターフェイス クラスの既定値として設定するデバイス インターフェイスを含むデバイス情報セットに対する DevInfoSet ハンドルを取得します。 デバイス インターフェイス要素への DeviceInterfaceData ポインターを取得するには、 SetupDiEnumDeviceInterfaces を 呼び出して、デバイス情報セット内のインターフェイスを列挙します。 列挙インターフェイスに関する情報を取得するには、 SetupDiGetDeviceInterfaceDetail を呼び出します。

要件

こちらもご覧ください

SetupDiEnumDeviceInterfaces

SetupDiGetClassDevs

SetupDiGetDeviceInterfaceDetail