Funzione SerCx2SaveReceiveFifoOnD0Exit (sercx.h)

Articolo
02/29/2024

Il metodo SerCx2SaveReceiveFifoOnD0Exit informa la versione 2 dell'estensione del framework seriale (SerCx2) che la ricezione FIFO dell'hardware del controller seriale contiene dati che devono essere salvati prima che il controller seriale entri in uno stato di scarsa potenza del dispositivo.

Sintassi

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

Parametri

[in] PioReceive

Handle SERCX2PIORECEIVE a un oggetto di ricezione PIO. Il driver del controller seriale precedentemente denominato metodo SerCx2PioReceiveCreate per creare questo oggetto.

[in] FifoSize

Numero di byte di dati non letti contenuti nella trasmissione FIFO.

Valore restituito

nessuno

Osservazioni

Quando il controller seriale sta per entrare in uno stato a basso consumo, SerCx2 e il driver del controller seriale devono salvare tutti i byte di dati non letti che potrebbero rimanere nella ricezione FIFO. In caso contrario, questi dati andranno persi quando il controller seriale entra nello stato a basso consumo. Per richiedere assistenza da SerCx2 per salvare questi dati, il driver chiama SerCx2SaveReceiveFifoOnD0Exit.

Il framework driver chiama la funzione di callback degli eventi EvtDeviceD0Exit o EvtDeviceD0ExitPreInterruptsDisabled del driver per indicare al driver di preparare il controller seriale per uscire dallo stato del dispositivo D0. In risposta, questa funzione deasse prima di tutto la riga pronta per l'invio (RTS) per indicare al dispositivo sull'altra estremità della connessione seriale di non inviare altri dati. La funzione chiama quindi SerCx2SaveReceiveFifoOnD0Exit.

SerCx2SaveReceiveFifoOnD0Exit chiama la funzione di callback dell'evento EvtSerCx2PioReceiveReadBuffer del driver per recuperare i dati dalla ricezione FIFO. In questa chiamata SerCx2 fornisce, come parametro, un puntatore a un buffer software interno gestito da SerCx2 allo scopo di salvare i dati non letti dalla ricezione FIFO in preparazione all'immissione di uno stato a basso consumo.

Successivamente, dopo che un client invia una richiesta di lettura (IRP_MJ_READ) al controller seriale, SerCx2 copia i byte da questo buffer software interno al buffer di lettura nella richiesta.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 8.1.
Piattaforma di destinazione	Universale
Intestazione	sercx.h
IRQL	PASSIVE_LEVEL