Funzione SerCx2SystemDmaReceiveNewDataNotification (sercx.h)

Articolo
10/30/2024

Il metodo SerCx2SystemDmaReceiveNewDataNotification notifica alla versione 2 dell'estensione del framework seriale (SerCx2) che i dati sono disponibili per essere letti dalla ricezione FIFO nell'hardware del controller seriale.

Sintassi

void SerCx2SystemDmaReceiveNewDataNotification(
  [in] SERCX2SYSTEMDMARECEIVE SystemDmaReceive
);

Parametri

[in] SystemDmaReceive

Handle SERCX2SYSTEMDMARECEIVE a un oggetto system-DMA-receive. Il driver del controller seriale precedentemente chiamato il metodo SerCx2SystemDmaReceiveCreate per creare questo oggetto.

Valore restituito

Nessuno

Osservazioni

Se la ricezione FIFO nel controller seriale diventa vuota prima che una transazione di ricezione DMA di sistema possa essere completata, SerCx2 chiama il EvtSerCx2SystemDmaReceiveEnableNewDataNotification funzione di callback degli eventi, se implementata, per consentire a SerCx2 di ricevere una notifica di nuovi dati quando i dati sono nuovamente disponibili per la lettura da FIFO.

Se la notifica dei nuovi dati è abilitata, il driver del controller seriale deve chiamare SerCx2SystemDmaReceiveNewDataNotification per notificare a SerCx2 dopo che il controller seriale riceve nuovi dati. Una notifica si verifica quando il driver rileva che uno o più nuovi byte di dati ricevuti sono pronti per essere trasferiti o sono già stati trasferiti dal controller DMA di sistema.

Il controller seriale deve chiamare SerCx2SystemDmaReceiveNewDataNotification solo in risposta a una chiamata alla funzione EvtSerCx2SystemDmaReceiveEnableNewDataNotification.

Se un driver del controller seriale supporta le notifiche dei nuovi dati per le transazioni di ricezione DMA di sistema, SerCx usa queste notifiche per rilevare i timeout dell'intervallo durante la gestione delle richieste di lettura (IRP_MJ_READ). Per altre informazioni sui timeout degli intervalli, vedere SERIAL_TIMEOUTS. Per altre informazioni sulle notifiche dei nuovi dati, vedere SerCx2 System-DMA-Receive Transactions.