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

Статья
02/29/2024

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

Синтаксис

EVT_SERCX_TRANSMIT_CANCEL EvtSercxTransmitCancel;

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

Параметры

[in] Device

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

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

None

Remarks

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

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

Примеры

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

typedef VOID
  EVT_SERCX_TRANSMIT_CANCEL(
    __in WDFDEVICE Device
    );

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

EVT_SERCX_TRANSMIT_CANCEL MyEvtSerCxTransmitCancel;

Затем реализуйте функцию обратного вызова, как показано ниже.

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

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

Требования

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

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