HwNProcessAddDevicePreDeviceCreate 函数 (hwnclx.h)
将设备准备/释放和进入/退出回调提供给 Windows 驱动程序基础 (WDF) ,以便将设备转换为不同的状态。 当 WDF 调用驱动程序的 EVT_WDF_DRIVER_DEVICE_ADD 例程时,但在创建设备对象之前,客户端驱动程序应调用此函数。
语法
FORCEINLINE NTSTATUS HwNProcessAddDevicePreDeviceCreate(
_In_ WDFDRIVER Driver,
_In_ PWDFDEVICE_INIT DeviceInit,
_Out_ PWDF_OBJECT_ATTRIBUTES FdoAttributes
);
参数
[in] Driver
客户端驱动程序框架驱动程序对象的句柄。
[in] DeviceInit
指向框架分配 的WDFDEVICE_INIT 结构的指针。
[out] FdoAttributes
指向 WDF_OBJECT_ATTRIBUTES 结构的指针,该结构描述客户端驱动程序的设备对象在创建时的属性。
返回值
如果函数成功,则返回STATUS_SUCCESS。 如果找不到相应的客户端驱动程序,则返回STATUS_INVALID_PARAMETER。 否则,它将返回 Ntstatus.h 中定义的错误状态值之一。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 10 版本 1709 |
最低受支持的服务器 | Windows Server 2016 |
目标平台 | Windows |
标头 | hwnclx.h |
Library | Mshwnclxstub.lib |
IRQL | PASSIVE_LEVEL |