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

Статья
02/29/2024

Функция обратного вызова события EvtSerCxReceiveCancel уведомляет драйвер последовательного контроллера об отмене ожидающего запроса на получение.

Синтаксис

EVT_SERCX_RECEIVE_CANCEL EvtSercxReceiveCancel;

void EvtSercxReceiveCancel(
  [in] WDFDEVICE Device
)
{...}

Параметры

[in] Device

Дескриптор WDFDEVICE для объекта устройства платформы, представляющего последовательный контроллер.

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

None

Remarks

Расширение последовательной платформы (SerCx) вызывает эту функцию, чтобы сообщить драйверу последовательного контроллера о том, что текущий запрос на получение отменен. Если драйвер выполняет незавершенную операцию получения, драйвер должен отменить эту операцию и вызвать метод SerCxProgressReceive , чтобы сообщить об отмене. В вызове SerCxProgressReceive задайте для параметра BytesReceived число байтов, полученных до отмены операции, а для параметра ReceiveStatus — значение SerCxStatusCancelled.

Чтобы зарегистрировать функцию обратного вызова EvtSerCxReceiveCancel , драйвер должен вызвать метод SerCxInitialize .

Примеры

Тип функции для этого обратного вызова объявлен в Sercx.h следующим образом.

typedef VOID
  EVT_SERCX_RECEIVE_CANCEL(
    __in WDFDEVICE Device
    );

Чтобы определить функцию обратного вызова EvtSerCxReceiveCancel с именем MyEvtSerCxReceiveCancel, необходимо сначала предоставить объявление функции, которое требуется для статического средства проверки драйверов (SDV) и других средств проверки, как показано ниже.

EVT_SERCX_RECEIVE_CANCEL MyEvtSerCxReceiveCancel;

Затем реализуйте функцию обратного вызова следующим образом.

VOID
  MyEvtSerCxReceiveCancel(
    __in WDFDEVICE Device
    )
{ ... }

Дополнительные сведения о требованиях SDV для объявлений функций см. в статье Объявление функций с помощью типов ролей функций для драйверов KMDF.

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows 8.
Целевая платформа	Персональный компьютер
Верхняя часть	sercx.h
IRQL	Вызывается в IRQL <= DISPATCH_LEVEL

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

SerCxInitialize

SerCxProgressReceive

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