Функция UdecxWdfDeviceNeedsReset (udecxwdfdevice.h)

Статья
02/07/2025

Сообщает расширению класса эмуляции 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	N/A
заголовка	udecxwdfdevice.h (include Udecx.h)
библиотеки	Udecxstub.lib
IRQL	PASSIVE_LEVEL

См. также

UDECX_WDF_DEVICE_RESET_TYPE

Поделиться через