функция обратного вызова EVT_SERCX2_PIO_TRANSMIT_CLEANUP_TRANSACTION (sercx.h)
Функция обратного вызова событий EvtSerCx2PioTransmitCleanupTransaction вызывается версией 2 расширения последовательной платформы (SerCx2), чтобы очистить состояние последовательного контроллера после завершения транзакции передачи PIO.
Синтаксис
EVT_SERCX2_PIO_TRANSMIT_CLEANUP_TRANSACTION EvtSercx2PioTransmitCleanupTransaction;
void EvtSercx2PioTransmitCleanupTransaction(
[in] SERCX2PIOTRANSMIT PioTransmit
)
{...}
Параметры
[in] PioTransmit
Дескриптор SERCX2PIOTRANSMIT объекту PIO-передачи. Драйвер последовательного контроллера, ранее называемый методом SerCx2PioTransmitCreate для создания этого объекта.
Возвращаемое значение
Никакой
Замечания
Драйвер последовательного контроллера может реализовать эту функцию в качестве параметра. При реализации драйвер регистрирует функцию в вызове SerCx2PioTransmitCreate, который создает объект PIO-передачи.
Драйвер последовательного контроллера должен реализовать функцию EvtSerCx2PioTransmitCleanupTransaction, если необходимо очистить состояние последовательного контроллера в конце транзакции передачи PIO. SerCx2 вызывает эту функцию, если она реализована, после завершения транзакции передачи пино-данных. В ответ на вызов EvtSerCx2PioTransmitCleanupTrans action драйвер последовательного контроллера должен вызвать метод SerCx2PioTransmitCleanupTransactionComplete, чтобы уведомить SerCx2 после завершения очистки.
Дополнительные сведения см. в разделе SerCx2 PIO-Transmit Транзакций.
Примеры
Чтобы определить функцию обратного вызова EvtSerCx2PioTransmitCleanupTransaction, необходимо сначала указать объявление функции, определяющее тип определяемой функции обратного вызова. Windows предоставляет набор типов функций обратного вызова для драйверов. Объявление функции с помощью типов функций обратного вызова помогает анализ кода для драйверов, статический проверяющий драйвер (SDV) и другие средства проверки подлинности, и это требование для написания драйверов для операционной системы Windows.
Например, чтобы определить функцию обратного вызова EvtSerCx2PioTransmitCleanupTransaction, которая называется MyPioTransmitCleanupTransaction, используйте тип функции EVT_SERCX2_PIO_TRANSMIT_CLEANUP_TRANSACTION, как показано в этом примере кода:
EVT_SERCX2_PIO_TRANSMIT_CLEANUP_TRANSACTION MyPioTransmitCleanupTransaction;
Затем реализуйте функцию обратного вызова следующим образом:
_Use_decl_annotations_
VOID
MyPioTransmitCleanupTransaction(
SERCX2PIOTRANSMIT PioTransmit
)
{...}
Тип функции EVT_SERCX2_PIO_TRANSMIT_CLEANUP_TRANSACTION определен в файле заголовка Sercx.h. Чтобы более точно определить ошибки при запуске средств анализа кода, обязательно добавьте в определение функции заметку Use_decl_annotations. Заметка Use_decl_annotations гарантирует, что используются заметки, применяемые к типу функции EVT_SERCX2_PIO_TRANSMIT_CLEANUP_TRANSACTION в файле заголовка. Дополнительные сведения о требованиях к объявлениям функций см. в объявлении функций с помощью типов ролей функций для драйверов KMDF. Дополнительные сведения о
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно начиная с Windows 8.1. |
| целевая платформа | Настольный |
| заголовка | sercx.h |
| IRQL | Вызывается в IRQL <= DISPATCH_LEVEL. |