Функция 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