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

指向 SP_DEVICE_INTERFACE_DATA 结构的指针，该结构指定 DeviceInfoSet 中的设备接口。

[in] Flags

未使用，必须为零。

Reserved

保留以供将来使用，必须为 NULL。

返回值

如果成功，该函数将返回 TRUE 。 否则，它将返回 FALSE ，并且可以通过调用 GetLastError 来检索记录的错误。

注解

调用方必须具有管理员权限才能设置设备接口类的默认接口。 但是，如果请求的默认接口与当前设置的默认接口相同，则无论调用方是否具有管理员权限，函数都会返回 TRUE 。

如果函数成功将指定的设备接口设置为设备类的默认接口，则会更新提供的 SP_DEVICE_INTERFACE_DATA 结构的 Flags 成员。

调用 SetupDiGetClassDevs 以获取设备信息集的 DevInfoSet 句柄，该设备信息集包含要设置为设备接口类的默认接口的设备接口。 若要获取指向设备接口元素的 DeviceInterfaceData 指针，请调用 SetupDiEnumDeviceInterfaces 以枚举设备信息集中的接口。 若要检索有关枚举接口的信息，请调用 SetupDiGetDeviceInterfaceDetail。

要求

要求 值
最低受支持的客户端 在 Windows XP 和更高版本的 Windows 中可用。
目标平台 桌面
标头 setupapi.h (包括 Setupapi.h)
Library Setupapi.lib
DLL Setupapi.dll

另请参阅

SetupDiEnumDeviceInterfaces

SetupDiGetClassDevs

SetupDiGetDeviceInterfaceDetail