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，则禁用它。

返回值

无

备注

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

在设备启动之前 (例如从 EvtDriverDeviceAdd、 EvtChildListCreateDevice 或 EvtDevicePrepareHardware) 调用时，驱动程序应将 IsInterfaceEnabled 设置为 FALSE，以防止在 PnP 启动时自动启用接口。 在设备启动前将 参数设置为 TRUE 是多余的，应删除此类调用。

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

要求

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

另请参阅

WdfDeviceSetDeviceInterfaceState

启用和禁用设备接口