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) |
库 | Wdf01000.sys(KMDF):WUDFx02000.dll (UMDF) |
IRQL | PASSIVE_LEVEL |