UdecxWdfDeviceNeedsReset 函数 (udecxwdfdevice.h)

  • 项目

通知 USB 设备仿真类扩展 (UdeCx) 设备需要重置操作。

语法

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

参数

[In] UdeWdfDevice

表示 USB 设备的框架设备对象的句柄。 客户端驱动程序在上一次调用 UdecxWdfDeviceAddUsbDeviceEmulation 中初始化了此对象。

[In] ResetType

指示重置类型的 UDECX_WDF_DEVICE_RESET_TYPE类型值。 目前仅 UdecxWdfDeviceResetAttemptPlatformLevelDeviceReset 支持 。

返回值

如果操作成功，函数将返回STATUS_SUCCESS。 否则，返回相应的 NTSTATUS 错误代码。

注解

如果现有的重置操作正在进行中，则函数将失败并出现STATUS_DEVICE_BUSY错误。 请注意，目前仅 UdecxWdfDeviceResetAttemptPlatformLevelDeviceReset 支持。 不支持 UdecxWdfDeviceResetAttemptFunctionLevelDeviceReset。

要求

要求 值
最低 KMDF 版本 1.27
最低 UMDF 版本 不可用
标头 udecxwdfdevice.h (包括 Udecx.h)
Library Udecxstub.lib
IRQL PASSIVE_LEVEL

另请参阅

UDECX_WDF_DEVICE_RESET_TYPE