Функция SerCx2CustomReceiveTransactionNewDataNotification (sercx.h)

  • Статья

Метод SerCx2CustomReceiveTransactionNewDataNotification уведомляет версию 2 расширения последовательной платформы (SerCx2) о том, что данные доступны для чтения из получающего FIFO на оборудовании последовательного контроллера.

Синтаксис

void SerCx2CustomReceiveTransactionNewDataNotification(
  [in] SERCX2CUSTOMRECEIVETRANSACTION CustomReceiveTransaction
);

Параметры

[in] CustomReceiveTransaction

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

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

None

Remarks

Если fifo получения в последовательном контроллере становится пустым до завершения транзакции пользовательского получения, SerCx2 вызывает функцию обратного вызова события EvtSerCx2CustomReceiveTransactionEnableNewDataNotification , если она реализована, чтобы включить уведомление о новых данных, когда новые данные доступны для чтения из получающего FIFO.

Если уведомления о новых данных включены и новые данные доступны для чтения, драйвер последовательного контроллера должен вызвать SerCx2CustomReceiveTransactionNewDataNotification , чтобы уведомить SerCx2. Это уведомление возникает, когда драйвер обнаруживает, что один или несколько новых байтов полученных данных либо готовы к передаче с помощью пользовательского механизма передачи данных, либо уже переданы этим механизмом.

Драйвер последовательного контроллера должен вызывать SerCx2CustomReceiveTransactionNewDataNotification только в ответ на вызов функции EvtSerCx2CustomReceiveTransactionEnableNewDataNotification .

Если драйвер последовательного контроллера поддерживает уведомления о новых данных для транзакций пользовательского получения, SerCx использует эти уведомления для обнаружения интервалов времени ожидания во время обработки запросов на чтение (IRP_MJ_READ). Дополнительные сведения о времени ожидания интервала см. в разделе SERIAL_TIMEOUTS. Дополнительные сведения об уведомлениях о новых данных см. в разделе SerCx2 Custom-Receive Transactions.

Требования

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

См. также раздел

EvtSerCx2CustomReceiveTransactionEnableNewDataNotification

IRP_MJ_READ

SERCX2CUSTOMRECEIVETRANSACTION

SERIAL_TIMEOUTS

SerCx2CustomReceiveTransactionCreate