WdfDeviceSetPnpCapabilities 函数 （wdfdevice.h）

[适用于 KMDF 和 UMDF]

WdfDeviceSetPnpCapabilities 方法报告设备的即插即用功能。

语法

void WdfDeviceSetPnpCapabilities(
  [in] WDFDEVICE                    Device,
  [in] PWDF_DEVICE_PNP_CAPABILITIES PnpCapabilities
);

参数

[in] Device

框架设备对象的句柄。

[in] PnpCapabilities

指向驱动程序分配 WDF_DEVICE_PNP_CAPABILITIES 结构的指针。

返回值

没有

言论

如果驱动程序提供无效的对象句柄，则会发生 bug 检查。

驱动程序通常从以下回调函数之一中调用 WdfDeviceSetPnpCapabilities：

• EvtDriverDeviceAdd

• EvtDevicePrepareHardware

• EvtDeviceD0Entry（如果 PreviousState 参数的值 WdfPowerDeviceD3Final）

• EvtDeviceSelfManagedIoInit

• EvtChildListCreateDevice

如果设备的驱动程序堆栈中的多个驱动程序调用 WdfDeviceSetPnpCapabilities，即插即用管理器将使用堆栈中最高驱动程序提供的值。

例子

以下代码示例初始化WDF_DEVICE_PNP_CAPABILITIES结构，然后调用 WdfDeviceSetPnpCapabilities。

WDF_DEVICE_PNP_CAPABILITIES  pnpCaps;

WDF_DEVICE_PNP_CAPABILITIES_INIT(&pnpCaps);
pnpCaps.SurpriseRemovalOK = WdfTrue;

WdfDeviceSetPnpCapabilities(
                            device,
                            &pnpCaps
                            );

要求

要求	价值
目标平台	普遍
最低 KMDF 版本	1.0
最低 UMDF 版本	2.0
标头	wdfdevice.h （包括 Wdf.h）
库	Wdf01000.sys（KMDF）：WUDFx02000.dll （UMDF）
IRQL	<=DISPATCH_LEVEL
DDI 符合性规则	DriverCreate（kmdf），KmdfIrql（kmdf），KmdfIrql2（kmdf），KmdfIrqlExplicit（kmdf）

另请参阅

WDF_DEVICE_PNP_CAPABILITIES

WDF_DEVICE_PNP_CAPABILITIES_INIT

WdfDeviceSetPowerCapabilities