Función SerCx2SaveReceiveFifoOnD0Exit (sercx.h)

Artículo
10/30/2024

El método SerCx2SaveReceiveFifoOnD0Exit informa a la versión 2 de la extensión del marco serie (SerCx2) que el FIFO de recepción del hardware del controlador serie contiene datos que deben guardarse antes de que el controlador serie entre en un estado de baja potencia del dispositivo.

Sintaxis

void SerCx2SaveReceiveFifoOnD0Exit(
  [in] SERCX2PIORECEIVE PioReceive,
  [in] ULONG            FifoSize
);

Parámetros

[in] PioReceive

Identificador de SERCX2PIORECEIVE a un objeto pio-receive. El controlador de controlador serie llamó anteriormente al método SerCx2PioReceiveCreate para crear este objeto.

[in] FifoSize

Número de bytes de datos no leídos que contiene fiFO de transmisión.

Valor devuelto

Ninguno

Observaciones

Cuando el controlador serie está a punto de entrar en un estado de baja potencia, SerCx2 y el controlador del controlador de controlador serie deben guardar los bytes de datos no leídos que podrían permanecer en el FIFO de recepción. De lo contrario, estos datos se perderán cuando el controlador serie entre en el estado de baja potencia. Para solicitar ayuda de SerCx2 para guardar estos datos, el controlador llama a SerCx2SaveReceiveFifoOnD0Exit.

El marco de trabajo del controlador llama al EvtDeviceD0Exit o EvtDeviceD0ExitPreInterruptsDisabled función de devolución de llamada de eventos para indicar al controlador que prepare el controlador serie para salir del estado del dispositivo D0. En respuesta, esta función primero deserte el listo para enviar línea (RTS) para indicar al dispositivo en el otro extremo de la conexión serie que no envíe más datos. A continuación, la función llama a SerCx2SaveReceiveFifoOnD0Exit.

SerCx2SaveReceiveFifoOnD0Exit llama a la EvtSerCx2PioReceiveReadBuffer función de devolución de llamada de eventos para recuperar los datos del FIFO de recepción. En esta llamada, SerCx2 proporciona, como parámetro, un puntero a un búfer de software interno que SerCx2 mantiene con el fin de guardar datos no leídos de la recepción fiFO en preparación para entrar en un estado de baja potencia.

Más adelante, después de que un cliente envíe una solicitud de lectura (IRP_MJ_READ) al controlador serie, SerCx2 copia los bytes de este búfer de software interno en el búfer de lectura de la solicitud.