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 SERCX2CUSTOMRECEIVETRANSACTION per 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

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

Vedi anche

EvtSerCx2CustomReceiveTransactionEnableNewDataNotification

IRP_MJ_READ

SERCX2CUSTOMRECEIVETRANSACTION

SERIAL_TIMEOUTS

SerCx2CustomReceiveTransactionCreate