Condividi tramite


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 l'analisi del codice per i driver, del driver statico (SDV) e altri strumenti di verifica rilevano errori ed è un requisito per la scrittura di driver per il sistema operativo Windows.

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.

Vedere anche

SERCX2SYSTEMDMARECEIVE

SerCx2SystemDmaReceiveCreate

SerCx2SystemDmaReceiveInitializeTransactionComplete