EVT_SERCX2_SYSTEM_DMA_RECEIVE_INITIALIZE_TRANSACTION funzione di callback (sercx.h)
Il EvtSerCx2EvtSerCx2SystemDmaReceiveInitializeTransaction funzione di callback degli eventi viene chiamata dalla versione 2 dell'estensione del framework seriale (SerCx2) per preparare il driver del controller seriale per eseguire una transazione di ricezione system-DMA.
Sintassi
EVT_SERCX2_SYSTEM_DMA_RECEIVE_INITIALIZE_TRANSACTION EvtSercx2SystemDmaReceiveInitializeTransaction;
void EvtSercx2SystemDmaReceiveInitializeTransaction(
[in] SERCX2SYSTEMDMARECEIVE SystemDmaReceive,
[in] ULONG Length
)
{...}
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.
[in] Length
Numero di byte da trasferire nella transazione system-DMA-receive.
Valore restituito
Nessuno
Osservazioni
Il driver del controller seriale può, come opzione, implementare questa funzione. Se implementato, il driver registra la funzione nel SerCx2SystemDmaReceiveCreate chiamata che crea l'oggetto system-DMA-receive.
Il driver deve implementare una funzione EvtSerCx2EvtSerCx2SystemDmaReceiveInitializeTransaction se deve inizializzare il controller seriale e l'hardware associato in preparazione per una nuova transazione di ricezione system-DMA. SerCx2 chiama questa funzione, se implementata, prima dell'avvio di una transazione system-DMA-receive. In risposta a questa chiamata, il driver del controller seriale deve chiamare il metodo SerCx2SystemDmaReceiveInitializeTransactionComplete per notificare a SerCx2 al termine dell'inizializzazione.
Per altre informazioni, vedere SerCx2 System-DMA-Receive Transactions.
Esempi
Per definire un EvtSerCx2EvtSerCx2SystemDmaReceiveInitializeTransaction funzione di callback, è necessario innanzitutto fornire una dichiarazione di funzione che identifica il tipo di funzione di callback che si sta definendo. Windows fornisce un set di tipi di funzione di callback per i driver. La dichiarazione di una funzione usando i tipi di funzione di callback consente di
Ad esempio, per definire un EvtSerCx2EvtSerCx2SystemDmaReceiveInitializeTransaction funzione di callback denominata MySystemDmaReceiveInitializeTransaction, usare il tipo di funzione EVT_SERCX2_SYSTEM_DMA_RECEIVE_INITIALIZE_TRANSACTION, come illustrato nell'esempio di codice seguente:
EVT_SERCX2_SYSTEM_DMA_RECEIVE_INITIALIZE_TRANSACTION MySystemDmaReceiveInitializeTransaction;
Implementare quindi la funzione di callback come segue:
_Use_decl_annotations_
VOID
MySystemDmaReceiveInitializeTransaction(
SERCX2SYSTEMDMARECEIVE SystemDmaReceive,
ULONG Length
)
{...}
Il tipo di funzione EVT_SERCX2_SYSTEM_DMA_RECEIVE_INITIALIZE_TRANSACTION è definito nel file di intestazione Sercx.h. Per identificare in modo più accurato gli errori quando si eseguono gli strumenti di analisi del codice, assicurarsi di aggiungere l'annotazione Use_decl_annotations alla definizione della funzione. L'annotazione Use_decl_annotations assicura che vengano utilizzate le annotazioni applicate al tipo di funzione EVT_SERCX2_SYSTEM_DMA_RECEIVE_INITIALIZE_TRANSACTION nel file di intestazione. Per altre informazioni sui requisiti per le dichiarazioni di funzione, vedere Dichiarazione di funzioni tramite i tipi di ruolo della funzione per i driver KMDF. Per altre informazioni su Use_decl_annotations, vedere l'annotazione del comportamento della funzione.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile a partire da Windows 8.1. |
| piattaforma di destinazione | Desktop |
| intestazione |
sercx.h |
| IRQL | Chiamato in IRQL <= DISPATCH_LEVEL. |