функция обратного вызова EVT_UDECX_USB_DEVICE_D0_ENTRY (udecxusbdevice.h)
Расширение класса эмуляции USB-устройства (UdeCx) вызывает эту функцию обратного вызова при получении запроса на перенос виртуального USB-устройства из состояния низкой мощности в рабочее состояние.
Синтаксис
EVT_UDECX_USB_DEVICE_D0_ENTRY EvtUdecxUsbDeviceD0Entry;
NTSTATUS EvtUdecxUsbDeviceD0Entry(
[in] WDFDEVICE UdecxWdfDevice,
[in] UDECXUSBDEVICE UdecxUsbDevice
)
{...}
Параметры
[in] UdecxWdfDevice
Дескриптор объекта устройства платформы, представляющий контроллер, к которому подключено USB-устройство. Драйвер клиента инициализировал этот объект в предыдущем вызове UdecxWdfDeviceAddUsbDeviceEmulation.
[in] UdecxUsbDevice
Дескриптор объекта устройства UDE. Драйвер клиента создал этот объект в предыдущем вызове UdecxUsbDeviceCreate.
Возвращаемое значение
Если операция выполнена успешно, функция обратного вызова должна возвращать STATUS_SUCCESS или другое значение состояния, для которого NT_SUCCESS(состояние) равно TRUE.
Замечания
Драйвер клиента зарегистрировал функцию в предыдущем вызове UdecxUsbDeviceInitSetStateChangeCallbacks путем указания указателя функции на его реализацию.
В реализации обратного вызова драйвер клиента для USB-устройства, как ожидается, выполнит действия, чтобы ввести рабочее состояние.
Запрос питания можно выполнить асинхронно, возвращая STATUS_PENDING, а затем завершив его, вызвав UdecxUsbDeviceLinkExitComplete с фактическим кодом завершения.
Требования
Требование | Ценность |
---|---|
минимальные поддерживаемые клиентские | Windows 10 |
минимальный поддерживаемый сервер | Windows Server 2016 |
целевая платформа | Виндоус |
минимальная версия KMDF | 1.15 |
заголовка | udecxusbdevice.h (include Udecx.h) |
IRQL | <=DISPATCH_LEVEL |
См. также
архитектура : эмуляция USB-устройств (UDE)