EVT_UDECX_WDF_DEVICE_RESET callback function (udecxwdfdevice.h)

Article
10/21/2021

The UDE client driver's implementation to reset the emulated host controller or the devices attached to it.

Syntax

EVT_UDECX_WDF_DEVICE_RESET EvtUdecxWdfDeviceReset;

void EvtUdecxWdfDeviceReset(
  [in] WDFDEVICE UdecxWdfDevice
)
{...}

Parameters

[in] UdecxWdfDevice

A handle to a framework device object that represents the controller. The client driver initialized this object in the previous call to UdecxWdfDeviceAddUsbDeviceEmulation.

Return value

None

Remarks

The USB device emulation class extension (UdeCx) invokes this callback function to notify the client driver that it must handle a reset request including resetting all downstream devices attached to the emulated host controller. This call is asynchronous. The client driver signals completion with status information by calling UdecxWdfDeviceResetComplete. If the client specified UdeWdfDeviceResetActionResetEachUsbDevice in UDECX_WDF_DEVICE_CONFIG (during the UdecxWdfDeviceAddUsbDeviceEmulation call), this callback is never used. Instead, each connected attached device receives an EVT_UDECX_WDF_DEVICE_RESET callback.

Requirements

Requirement	Value
Minimum supported client	Windows 10
Minimum supported server	Windows Server 2016
Target Platform	Windows
Minimum KMDF version	1.15
Header	udecxwdfdevice.h (include Udecx.h)
IRQL	<=DISPATCH_LEVEL