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

另请参阅

硬件通知支持

硬件通知参考