функция обратного вызова EVT_UDECX_USB_ENDPOINT_PURGE (udecxusbendpoint.h)

  • Статья

Расширение класса эмуляции USB-устройства (UdeCx) вызывает эту функцию обратного вызова, чтобы остановить постановку в очередь запросов ввода-вывода в очередь конечной точки и отменить необработанные запросы.

Синтаксис

EVT_UDECX_USB_ENDPOINT_PURGE EvtUdecxUsbEndpointPurge;

void EvtUdecxUsbEndpointPurge(
  [in] UDECXUSBENDPOINT UdecxUsbEndpoint
)
{...}

Параметры

[in] UdecxUsbEndpoint

Дескриптор объекта конечной точки UDE, представляющий конечную точку, для которой необходимо отменить запросы ввода-вывода. Драйвер клиента извлек этот указатель при предыдущем вызове UdecxUsbEndpointCreate.

Возвращаемое значение

None

Remarks

Драйвер клиента зарегистрировал эту функцию обратного вызова в предыдущем вызове UdecxUsbEndpointInitSetCallbacks , указав указатель функции на ее реализацию.

В реализации драйвер клиента должен убедиться, что все операции ввода-вывода, переадресованные из очереди конечной точки, завершены, а недавно перенаправленный запрос ввода-вывода завершается сбоем, пока UdeCx не вызовет EVT_UDECX_USB_ENDPOINT_START. Как правило, эти задачи выполняются путем вызова WdfIoQueuePurge. Этот вызов является асинхронным, и клиентская река должна вызывать UdecxUsbEndpointPurgeComplete.

Требования

Требование Значение
Минимальная версия клиента Windows 10
Минимальная версия сервера Windows Server 2016
Целевая платформа Windows
Минимальная версия KMDF 1.15
Верхняя часть udecxusbendpoint.h (включая Udecx.h)
IRQL <=DISPATCH_LEVEL

См. также раздел

Архитектура: эмуляция USB-устройств (UDE)

Управление очередями ввода-вывода

Написание драйвера клиента UDE