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

Статья
02/07/2025

Реализация драйвера клиента, которая завершает все невыполненные запросы ввода-вывода в конечной точке.

Синтаксис

EVT_UCX_ENDPOINT_PURGE EvtUcxEndpointPurge;

void EvtUcxEndpointPurge(
  [in] UCXCONTROLLER UcxController,
  [in] UCXENDPOINT UcxEndpoint
)
{...}

Параметры

[in] UcxController

Дескриптор контроллера UCX, полученного драйвером клиента в предыдущем вызове метода UcxControllerCreate.

[in] UcxEndpoint

Дескриптор объекта UCXENDPOINT, представляющего конечную точку.

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

Никакой

Замечания

Драйвер клиента UCX регистрирует эту функцию обратного вызова с расширением контроллера USB-узла (UCX), вызывая метод UcxEndpointCreate.

Как правило, эта функция вызывает WdfIoQueuePurge.

После вызова этой функции UCX драйвер клиента завершает последующие запросы ввода-вывода, пока UCX не вызывает функцию обратного вызова EVT_UCX_ENDPOINT_START драйвера клиента.

Примеры

VOID
Endpoint_UcxEvtEndpointPurge(
    UCXCONTROLLER   UcxController,
    UCXENDPOINT     UcxEndpoint
    )
{
            WdfIoQueuePurge(endpointContext->WdfQueue,
                            Endpoint_WdfEvtPurgeComplete,
                            UcxEndpoint);
}

Требования

Требование	Ценность
целевая платформа	Виндоус
минимальная версия KMDF	1.0
минимальная версия UMDF	2.0
заголовка	ucxendpoint.h (include Ucxclass.h, Ucxendpoint.h)
IRQL	DISPATCH_LEVEL

См. также

WdfIoQueuePurge

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