функция обратного вызова EVT_SERCX2_PIO_TRANSMIT_CANCEL_READY_NOTIFICATION (sercx.h)
Функция обратного вызова событий EvtSerCx2PioTransmitCancelReadyNotification вызывается версией 2 расширения последовательной платформы (SerCx2), чтобы отменить готовое уведомление о том, что SerCx2 включен в предыдущем вызове функции обратного вызова EvtSerCx2PioTransmitEnableReadyNotification функции обратного вызова событий.
Синтаксис
EVT_SERCX2_PIO_TRANSMIT_CANCEL_READY_NOTIFICATION EvtSercx2PioTransmitCancelReadyNotification;
BOOLEAN EvtSercx2PioTransmitCancelReadyNotification(
[in] SERCX2PIOTRANSMIT PioTransmit
)
{...}
Параметры
[in] PioTransmit
Дескриптор SERCX2PIOTRANSMIT объекту PIO-передачи. Драйвер последовательного контроллера, ранее называемый методом SerCx2PioTransmitCreate для создания этого объекта.
Возвращаемое значение
Функция EvtSerCx2PioTransmitCancelReadyNot ification возвращает TRUE, если готовое уведомление было успешно отключено, а драйвер последовательного контроллера может гарантировать, что это уведомление не приведет к вызову метода SerCx2PioTransmitReady.
Функция возвращает FALSE, если драйвер уже вызвал SerCx2PioTransmitReadyили будет вызывать этот метод.
Замечания
Драйвер последовательного контроллера должен реализовать эту функцию. Драйвер регистрирует функцию в вызове SerCx2PioTransmitCreate, который создает объект piO-передачи.
Если связанный запрос записи истекает или отменяется во время включения готового уведомления, SerCx2 вызывает функцию EvtSerCx2PioTransmitCancelReadyNotification, чтобы отменить ожидающее уведомление. Если этот вызов возвращает FALSE, SerCx2 ожидает, что драйвер последовательного контроллера вызовет SerCx2PioTransmitReady; только после этого вызова SerCx2 вызывает функцию обратного вызова события EvtSerCx2PioTransmitCleanupTransaction функцию обратного вызова событий, если она реализована, и завершите запрос.
Чтобы отменить ранее включенное уведомление о готовности, функция EvtSerCx2PioTransmitCancelReadyNotification обычно отключает прерывание в последовательном контроллере, указывающее, что передача FIFO готова принимать дополнительные данные. SerCx2 включил это прерывание в предыдущем вызове функции EvtSerCx2PioTransmitEnableReadyNotification.
Дополнительные сведения см. в разделе SerCx2 PIO-Transmit Транзакций.
Примеры
Чтобы определить функцию обратного вызова EvtSerCx2PioTransmitCancelReadyNotification, необходимо сначала указать объявление функции, определяющее тип определяемой функции обратного вызова. Windows предоставляет набор типов функций обратного вызова для драйверов. Объявление функции с помощью типов функций обратного вызова помогает анализ кода для драйверов, статический проверяющий драйвер (SDV) и другие средства проверки подлинности, и это требование для написания драйверов для операционной системы Windows.
Например, чтобы определить функцию обратного вызова EvtSerCx2PioTransmitCancelReadyNotification, которая называется MyPioTransmitCancelReadyNotification, используйте тип функции EVT_SERCX2_PIO_TRANSMIT_CANCEL_READY_NOTIFICATION, как показано в этом примере кода:
EVT_SERCX2_PIO_TRANSMIT_CANCEL_READY_NOTIFICATION MyPioTransmitCancelReadyNotification;
Затем реализуйте функцию обратного вызова следующим образом:
_Use_decl_annotations_
BOOLEAN
MyPioTransmitCancelReadyNotification(
SERCX2PIOTRANSMIT PioTransmit
)
{...}
Тип функции EVT_SERCX2_PIO_TRANSMIT_CANCEL_READY_NOTIFICATION определен в файле заголовка Sercx.h. Чтобы более точно определить ошибки при запуске средств анализа кода, обязательно добавьте в определение функции заметку Use_decl_annotations. Заметка Use_decl_annotations гарантирует, что используются заметки, применяемые к типу функции EVT_SERCX2_PIO_TRANSMIT_CANCEL_READY_NOTIFICATION в файле заголовка. Дополнительные сведения о требованиях к объявлениям функций см. в объявлении функций с помощью типов ролей функций для драйверов KMDF. Дополнительные сведения о
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно начиная с Windows 8.1. |
| целевая платформа | Настольный |
| заголовка | sercx.h |
| IRQL | Вызывается в IRQL <= DISPATCH_LEVEL. |