Función SerCx2CustomReceiveTransactionNewDataNotification (sercx.h)

Artículo
10/30/2024

El método SerCx2CustomReceiveTransactionNewDataNotification notifica a la versión 2 de la extensión de marco serie (SerCx2) que los datos están disponibles para leerse desde el FIFO de recepción en el hardware del controlador serie.

Sintaxis

void SerCx2CustomReceiveTransactionNewDataNotification(
  [in] SERCX2CUSTOMRECEIVETRANSACTION CustomReceiveTransaction
);

Parámetros

[in] CustomReceiveTransaction

Identificador de SERCX2CUSTOMRECEIVETRANSACTION a un objeto de recepción personalizado. El controlador de controlador serie llamó anteriormente al método SerCx2CustomReceiveTransactionCreate para crear este objeto.

Valor devuelto

Ninguno

Observaciones

Si el FIFO de recepción en el controlador serie se vacía antes de que se pueda completar una transacción de recepción personalizada, SerCx2 llama a la EvtSerCx2CustomReceiveTransactionEnableNewDataNotification función de devolución de llamada de eventos, si se implementa, para permitir que se produzca una notificación de datos nuevos cuando se puedan leer nuevos datos desde el FIFO de recepción.

Si las notificaciones de datos nuevos están habilitadas y hay nuevos datos disponibles para leerse, el controlador del controlador serie debe llamar a SerCx2CustomReceiveTransactionNewDataNotification para notificar a SerCx2. Esta notificación se produce cuando el controlador detecta que uno o varios bytes nuevos de datos recibidos están listos para ser transferidos por el mecanismo de transferencia de datos personalizado o ya se han transferido mediante este mecanismo.

El controlador del controlador serie debe llamar a serCx2CustomReceiveTransactionNewDataNotification solo en respuesta a una llamada a la función evtSerCx2CustomReceiveTransactionEnableNewDataNotification.

Si un controlador de controlador serie admite notificaciones de datos nuevos para transacciones de recepción personalizada, SerCx usa estas notificaciones para detectar tiempos de espera de intervalo durante el control de solicitudes de lectura (IRP_MJ_READ). Para obtener más información sobre los tiempos de espera de intervalo, consulte SERIAL_TIMEOUTS. Para obtener más información sobre las notificaciones de datos nuevos, consulte SerCx2 Custom-Receive Transactions.