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

Статья
10/30/2024

Функция обратного вызова событий EvtSerCx2CustomReceiveTransactionCleanup вызывается версией 2 расширения последовательной платформы (SerCx2), чтобы очистить состояние оборудования последовательного контроллера после завершения транзакции пользовательского получения.

Синтаксис

EVT_SERCX2_CUSTOM_RECEIVE_TRANSACTION_CLEANUP EvtSercx2CustomReceiveTransactionCleanup;

void EvtSercx2CustomReceiveTransactionCleanup(
  [in] SERCX2CUSTOMRECEIVETRANSACTION CustomReceiveTransaction
)
{...}

Параметры

[in] CustomReceiveTransaction

Дескриптор SERCX2CUSTOMRECEIVETRANSACTION для объекта пользовательской транзакции получения. Драйвер последовательного контроллера ранее вызвал метод SerCx2CustomReceiveTransactionCreate для создания этого объекта.

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

Никакой

Замечания

Драйвер последовательного контроллера может реализовать эту функцию в качестве параметра. При реализации драйвер регистрирует функцию в SerCx2CustomReceiveTransactionCreate вызов, который создает объект пользовательского получения.

Драйвер последовательного контроллера должен реализовать функцию EvtSerCx2CustomReceiveTransactionCleanup, если она должна очистить состояние последовательного контроллера в конце пользовательской транзакции получения. SerCx2 вызывает эту функцию, если она реализована, после завершения пользовательской транзакции получения. В ответ на вызов EvtSerCx2CustomReceiveTransactionClean up драйвер последовательного контроллера должен вызвать метод SerCx2CustomReceiveTransactionCleanupComplete, чтобы уведомить SerCx2 после завершения очистки.

Дополнительные сведения см. в разделе SerCx2 Custom-Receive Транзакций.

Примеры

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

Например, чтобы определить функцию обратного вызова EvtSerCx2CustomReceiveTransactionCleanup, которая называется MyCustomReceiveTransactionCleanup, используйте тип функции EVT_SERCX2_CUSTOM_RECEIVE_TRANSACTION_CLEANUP, как показано в этом примере кода:

EVT_SERCX2_CUSTOM_RECEIVE_TRANSACTION_CLEANUP  MyCustomReceiveTransactionCleanup;

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

_Use_decl_annotations_
VOID
  MyCustomReceiveTransactionCleanup(
    SERCX2CUSTOMRECEIVETRANSACTION  CustomReceiveTransaction
    )
  {...}

Тип функции EVT_SERCX2_CUSTOM_RECEIVE_TRANSACTION_CLEANUP определен в файле заголовка Sercx.h. Чтобы более точно определить ошибки при запуске средств анализа кода, обязательно добавьте в определение функции заметку Use_decl_annotations. Заметка Use_decl_annotations гарантирует, что используются заметки, применяемые к типу функции EVT_SERCX2_CUSTOM_RECEIVE_TRANSACTION_CLEANUP в файле заголовка. Дополнительные сведения о требованиях к объявлениям функций см. в объявлении функций с помощью типов ролей функций для драйверов KMDF. Дополнительные сведения о Use_decl_annotationsсм. в поведению функции.

Требования

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

См. также

SERCX2CUSTOMRECEIVETRANSACTION

SerCx2CustomReceiveTransactionCleanupComplete

SerCx2CustomReceiveTransactionCreate

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