Funzione SerCx2SystemDmaReceiveNewDataNotification (sercx.h)

Il metodo SerCx2SystemDmaReceiveNewDataNotification notifica la 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 in precedenza denominato il metodo SerCx2SystemDmaReceiveCreate per creare questo oggetto.

Valore restituito

nessuno

Osservazioni

Se la ricezione FIFO nel controller seriale diventa vuota prima che venga completata una transazione di ricezione DMA di sistema, SerCx2 chiama la funzione di callback dell'evento EvtSerCx2SystemDmaReceiveEnableNewDataNotification , se implementata, per consentire a SerCx2 di ricevere una notifica di nuovi dati quando i dati sono nuovamente disponibili per la lettura dalla ricezione FIFO.

Se la notifica dei nuovi dati è abilitata, il driver del controller seriale deve chiamare SerCx2SystemDmaReceiveNewDataNotification per notificare 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 del sistema, SerCx usa queste notifiche per rilevare i timeout di 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.

Requisiti

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

Vedi anche

EvtSerCx2SystemDmaReceiveEnableNewDataNotification

IRP_MJ_READ

SERCX2SYSTEMDMARECEIVE

SERIAL_TIMEOUTS

SerCx2SystemDmaReceiveCreate