Функция SerCx2CustomReceiveTransactionNewDataNotification (sercx.h)
Метод SerCx2CustomReceiveTransactionNewDataNotification уведомляет версию 2 расширения последовательной платформы (SerCx2), что данные доступны для чтения из получения FIFO на оборудовании последовательного контроллера.
Синтаксис
void SerCx2CustomReceiveTransactionNewDataNotification(
[in] SERCX2CUSTOMRECEIVETRANSACTION CustomReceiveTransaction
);
Параметры
[in] CustomReceiveTransaction
Дескриптор SERCX2CUSTOMRECEIVETRANSACTION для объекта пользовательского получения. Драйвер последовательного контроллера ранее вызвал метод SerCx2CustomReceiveTransactionCreate для создания этого объекта.
Возвращаемое значение
Никакой
Замечания
Если получение FIFO в последовательном контроллере становится пустым перед завершением транзакции пользовательского получения, SerCx2 вызывает EvtSerCx2CustomReceiveTransactionEnableNewDataNotification функцию обратного вызова событий, если она реализована, чтобы включить уведомление о новых данных, когда новые данные доступны для чтения из получения FIFO.
Если включены уведомления о новых данных и доступны новые данные, драйвер последовательного контроллера должен вызвать SerCx2CustomReceiveTransactionNewDataNotification для уведомления SerCx2. Это уведомление возникает, когда драйвер обнаруживает, что один или несколько новых байтов полученных данных готовы к передаче пользовательским механизмом передачи данных или уже переданы этим механизмом.
Драйвер последовательного контроллера должен вызывать SerCx2CustomReceiveTransactionNewDataNotification только в ответ на вызов функции EvtSerCx2CustomReceiveTransactionEnableNewDataNotification.
Если драйвер последовательного контроллера поддерживает уведомления о новых данных для пользовательских транзакций получения, SerCx использует эти уведомления для обнаружения интервалов времени ожидания во время обработки запросов чтения (IRP_MJ_READ) . Дополнительные сведения о времени ожидания интервала см. в SERIAL_TIMEOUTS. Дополнительные сведения о уведомлениях о новых данных см. в SerCx2 Custom-Receive транзакций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно начиная с Windows 8.1. |
| целевая платформа | Всеобщий |
| заголовка | sercx.h |
| IRQL | <= DISPATCH_LEVEL |
См. также
EvtSerCx2CustomReceiveTransactionEnableNewDataNotification