WdfDeviceSetDeviceInterfaceStateEx 函数 (wdfdevice.h)

WdfDeviceSetDeviceInterfaceStateEx 方法启用或禁用指定设备的设备接口。

语法

void WdfDeviceSetDeviceInterfaceStateEx(
  WDFDEVICE        Device,
  const GUID       *InterfaceClassGUID,
  PCUNICODE_STRING ReferenceString,
  BOOLEAN          IsInterfaceEnabled
);

参数

Device

框架设备对象的句柄。

InterfaceClassGUID

指向标识设备接口类的 GUID 的指针。

ReferenceString

指向描述设备接口引用字符串的 UNICODE_STRING 结构的指针。 此参数是可选的,可以 NULL

IsInterfaceEnabled

一个布尔值,如果 为 TRUE,则启用指定的设备接口实例;如果 FALSE,则禁用它。

返回值

没有

言论

驱动程序可以在设备启动之前或之后调用此函数。

在设备启动前调用(例如,从 EvtDriverDeviceAddEvtChildListCreateDeviceEvtDevicePrepareHardware),驱动程序应将 IsInterfaceEnabled 设置为 FALSE,以防止在 PnP 启动期间自动启用接口。 在设备启动时将参数设置为 TRUE 是冗余的,因此应删除此类调用。

在设备启动后调用时,行为与 WdfDeviceSetDeviceInterfaceState相同。

要求

要求 价值
最低支持的客户端 Windows 10 版本 2004
最低 KMDF 版本 1.31
最低 UMDF 版本 1.31
标头 wdfdevice.h (包括 Wdf.h)
Wdf01000.sys(KMDF):WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL

另请参阅

WdfDeviceSetDeviceInterfaceState

启用和禁用设备接口