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

Статья
12/16/2024

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

Синтаксис

EVT_SERCX_TRANSMIT_CANCEL EvtSercxTransmitCancel;

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

Параметры

[in] Device

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

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

Никакой

Замечания

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

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

Примеры

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

typedef VOID
  EVT_SERCX_TRANSMIT_CANCEL(
    __in WDFDEVICE Device
    );

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

EVT_SERCX_TRANSMIT_CANCEL MyEvtSerCxTransmitCancel;

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

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

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно начиная с Windows 8.
целевая платформа	Настольный
заголовка	sercx.h
IRQL	Вызывается в IRQL <= DISPATCH_LEVEL

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