EVT_SERCX2_SYSTEM_DMA_TRANSMIT_CONFIGURE_DMA_CHANNEL funzione di callback (sercx.h)
Il EvtSerCx2SystemDmaTransmitConfigureDmaChannel funzione di callback degli eventi viene chiamata dalla versione 2 dell'estensione del framework seriale (SerCx2) per consentire al driver del controller seriale di eseguire qualsiasi configurazione personalizzata della scheda DMA che potrebbe essere necessaria prima dell'avvio di ogni trasferimento DMA in una transazione di trasmissione DMA di sistema.
Sintassi
EVT_SERCX2_SYSTEM_DMA_TRANSMIT_CONFIGURE_DMA_CHANNEL EvtSercx2SystemDmaTransmitConfigureDmaChannel;
NTSTATUS EvtSercx2SystemDmaTransmitConfigureDmaChannel(
[in] SERCX2SYSTEMDMATRANSMIT SystemDmaTransmit,
[in] PMDL Mdl,
[in] ULONG Offset,
[in] ULONG Length
)
{...}
Parametri
[in] SystemDmaTransmit
Handle SERCX2SYSTEMDMATRANSMIT a un oggetto di trasmissione DMA di sistema. Il driver del controller seriale precedentemente denominato SerCx2SystemDmaTransmitCreate metodo per creare questo oggetto.
[in] Mdl
Puntatore a un MDL che descrive le pagine di memoria estese dal buffer di scrittura per la transazione di trasmissione system-DMA. L'elenco a dispersione/raccolta per il trasferimento DMA userà l'area di questa memoria specificata dai parametri offset
[in] Offset
Offset iniziale per il trasferimento dei dati. Questo parametro è un offset di byte dall'inizio dell'area del buffer descritta dal linguaggio MDL. Se MDL specifica un totale di N byte di spazio buffer, i valori possibili di Offset sono compresi nell'intervallo compreso tra 0 e N-1.
[in] Length
Dimensioni, in byte, del trasferimento dei dati. Se MDL specifica un totale di N byte di spazio buffer, i valori possibili di Length sono compresi nell'intervallo da 1 a N-Offset.
Valore restituito
La funzione evtSerCx2SystemDmaTransmitConfigureDmaChannel restituisce STATUS_SUCCESS se la chiamata ha esito positivo. In caso contrario, restituisce un codice di stato di errore appropriato.
Osservazioni
Il driver del controller seriale può, come opzione, implementare questa funzione. Se implementato, il driver registra la funzione nel SerCx2SystemDmaTransmitCreate chiamata che crea l'oggetto system-DMA-transmit.
Prima di avviare una transazione di trasmissione system-DMA, SerCx2 chiama la funzione EvtSerCx2SystemDmaTransmitConfigureDmaChannel, se implementata. Questa funzione esegue qualsiasi configurazione speciale del controller DMA di sistema che potrebbe essere necessario prima che SerCx2 avvii la transazione system-DMA-transmit.
Il driver del controller seriale può chiamare un metodo come SerCx2SystemDmaTransmitGetDmaEnabler per ottenere l'abilitazione DMA per il controller DMA di sistema usato per le transazioni di trasmissione DMA di sistema.
Per altre informazioni, vedere SerCx2 System-DMA-Transmit Transactions.
Esempi
Per definire un EvtSerCx2SystemDmaTransmitConfigureDmaChannel funzione di callback, è prima necessario 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 EvtSerCx2SystemDmaTransmitConfigureDmaChannel funzione di callback denominata MySystemDmaTransmitConfigureDmaChannel, usare il tipo di funzione EVT_SERCX2_SYSTEM_DMA_TRANSMIT_CONFIGURE_DMA_CHANNEL, come illustrato in questo esempio di codice:
EVT_SERCX2_SYSTEM_DMA_TRANSMIT_CONFIGURE_DMA_CHANNEL MySystemDmaTransmitConfigureDmaChannel;
Implementare quindi la funzione di callback come segue:
_Use_decl_annotations_
NTSTATUS
MySystemDmaTransmitConfigureDmaChannel(
SERCX2SYSTEMDMATRANSMIT SystemDmaTransmit,
PMDL Mdl,
ULONG Offset,
ULONG Length
)
{...}
Il tipo di funzione EVT_SERCX2_SYSTEM_DMA_TRANSMIT_CONFIGURE_DMA_CHANNEL è 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_TRANSMIT_CONFIGURE_DMA_CHANNEL 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. |