Funzione SerCx2CustomReceiveTransactionNewDataNotification (sercx.h)
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 di 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 la funzione di callback dell'evento EvtSerCx2CustomReceiveTransactionEnableNewDataNotification , se implementata, per abilitare una notifica di nuovi dati quando i nuovi dati sono disponibili per la lettura dalla funzione FIFO di ricezione.
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 di intervallo durante la gestione delle richieste di lettura (IRP_MJ_READ). Per altre informazioni sui timeout di intervallo, vedere SERIAL_TIMEOUTS. Per altre informazioni sulle notifiche dei nuovi dati, vedere SerCx2 Custom-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
EvtSerCx2CustomReceiveTransactionEnableNewDataNotification
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: nel corso del 2024 verranno dismessi i problemi di GitHub come meccanismo di feedback per il contenuto e verranno sostituiti con un nuovo sistema di feedback. Per altre informazioni, vedere:Invia e visualizza il feedback per