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 を呼び出します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP 以降のバージョンの Windows で使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | setupapi.h (Setupapi.h を含む) |
| Library | Setupapi.lib |
| [DLL] | Setupapi.dll |