Edit

HwNProcessAddDevicePreDeviceCreate function (hwnclx.h)

  • Article

Supplies the device prepare/release and entry/exit callbacks to the Windows Driver Foundation (WDF) for transitioning the device into different states. This function should be called by the client driver when the WDF invokes the driver’s EVT_WDF_DRIVER_DEVICE_ADD routine, but before creating the device object.

Syntax

FORCEINLINE NTSTATUS  HwNProcessAddDevicePreDeviceCreate(
  _In_  WDFDRIVER               Driver,
  _In_  PWDFDEVICE_INIT         DeviceInit,
  _Out_ PWDF_OBJECT_ATTRIBUTES  FdoAttributes
);

Parameters

[in] Driver

Handle to the client drivers framework driver object.

[in] DeviceInit

A pointer to a framework-allocated WDFDEVICE_INIT structure.

[out] FdoAttributes

Pointer to a WDF_OBJECT_ATTRIBUTES structure that describes the attributes of the client driver’s device object when it’s created.

Return value

Returns STATUS_SUCCESS if function succeeds. Returns STATUS_INVALID_PARAMETER if corresponding client driver can't be found. Otherwise, it returns one of the error status values defined in Ntstatus.h.

Requirements

Requirement Value
Minimum supported client Windows 10, version 1709
Minimum supported server Windows Server 2016
Target Platform Windows
Header hwnclx.h
Library Mshwnclxstub.lib
IRQL PASSIVE_LEVEL

See also

Hardware notifications support

Hardware notifications reference