UdecxWdfDeviceNeedsReset function (udecxwdfdevice.h)

  • Article

Informs the USB device emulation class extension (UdeCx) that the device needs a reset operation.

Syntax

NTSTATUS UdecxWdfDeviceNeedsReset(
  [In] WDFDEVICE                   UdeWdfDevice,
  [In] UDECX_WDF_DEVICE_RESET_TYPE ResetType
);

Parameters

[In] UdeWdfDevice

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

[In] ResetType

A UDECX_WDF_DEVICE_RESET_TYPE-type value that indicates the type of reset. Only UdecxWdfDeviceResetAttemptPlatformLevelDeviceReset is supported at this time.

Return value

The function returns STATUS_SUCCESS if the operation succeeds. Otherwise, returns an appropriate NTSTATUS error code.

Remarks

If an existing reset operation is in progress, the function fails with a STATUS_DEVICE_BUSY error. Note that only UdecxWdfDeviceResetAttemptPlatformLevelDeviceReset is supported at this time. UdecxWdfDeviceResetAttemptFunctionLevelDeviceReset is not supported.

Requirements

Requirement Value
Minimum KMDF version 1.27
Minimum UMDF version N/A
Header udecxwdfdevice.h (include Udecx.h)
Library Udecxstub.lib
IRQL PASSIVE_LEVEL

See also

UDECX_WDF_DEVICE_RESET_TYPE