Funzione SerCx2CustomReceiveTransactionNewDataNotification (sercx.h)

Articolo
10/30/2024

Il metodo SerCx2CustomReceiveTransactionNewDataNotification 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 SerCx2CustomReceiveTransactionNewDataNotification(
  [in] SERCX2CUSTOMRECEIVETRANSACTION CustomReceiveTransaction
);

Parametri

[in] CustomReceiveTransaction

Handle SERCX2CUSTOMRECEIVETRANSACTION a un oggetto di ricezione personalizzato. Il driver del controller seriale precedentemente denominato il metodo SerCx2CustomReceiveTransactionCreate per creare questo oggetto.

Valore restituito

Nessuno

Osservazioni

Se la ricezione FIFO nel controller seriale diventa vuota prima del completamento di una transazione di ricezione personalizzata, SerCx2 chiama il EvtSerCx2CustomReceiveTransactionEnableNewDataNotification funzione di callback degli eventi, se implementata, per consentire l'esecuzione di una notifica di nuovi dati quando i nuovi dati sono disponibili per essere letti dalla ricezione FIFO.

Se le notifiche dei nuovi dati sono abilitate e sono disponibili nuovi dati da leggere, il driver del controller seriale deve chiamare SerCx2CustomReceiveTransactionNewDataNotification per notificare a SerCx2. Questa notifica si verifica quando il driver rileva che uno o più nuovi byte di dati ricevuti sono pronti per essere trasferiti dal meccanismo di trasferimento dati personalizzato o sono già stati trasferiti da questo meccanismo.

Il driver del controller seriale deve chiamare SerCx2CustomReceiveTransactionNewDataNotification solo in risposta a una chiamata alla funzione EvtSerCx2CustomReceiveTransactionEnableNewDataNotification.

Se un driver del controller seriale supporta le notifiche dei nuovi dati per le transazioni di ricezione personalizzate, 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 Custom-Receive Transactions.