EVT_SERCX2_SYSTEM_DMA_RECEIVE_CONFIGURE_DMA_CHANNEL funzione di callback (sercx.h)
Il EvtSerCx2SystemDmaReceiveConfigureDmaChannel 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 in una transazione di ricezione DMA di sistema.
Sintassi
EVT_SERCX2_SYSTEM_DMA_RECEIVE_CONFIGURE_DMA_CHANNEL EvtSercx2SystemDmaReceiveConfigureDmaChannel;
NTSTATUS EvtSercx2SystemDmaReceiveConfigureDmaChannel(
[in] SERCX2SYSTEMDMARECEIVE SystemDmaReceive,
[in] PMDL Mdl,
[in] ULONG Offset,
[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] Mdl
Puntatore a un MDL che descrive le pagine di memoria estese dal buffer di lettura per la transazione di ricezione DMA di sistema. 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 EvtSerCx2SystemDmaReceiveConfigureDmaChannel 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 SerCx2SystemDmaReceiveCreate chiamata che crea l'oggetto system-DMA-receive.
Prima di avviare una transazione di ricezione DMA di sistema, SerCx2 chiama la funzione EvtSerCx2SystemDmaReceiveConfigureDmaChannel, se implementata. Questa funzione esegue qualsiasi configurazione speciale del controller DMA di sistema che potrebbe essere necessaria prima che SerCx2 avvii la transazione system-DMA-receive.
Il driver del controller seriale può chiamare un metodo come SerCx2SystemDmaReceiveGetDmaEnabler per ottenere l'abilitazione DMA per il controller DMA di sistema usato per le transazioni di ricezione DMA di sistema.
Per altre informazioni, vedere SerCx2 System-DMA-Receive Transactions.
Esempi
Per definire un EvtSerCx2SystemDmaReceiveConfigureDmaChannel funzione di callback, è innanzitutto 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 EvtSerCx2SystemDmaReceiveConfigureDmaChannel funzione di callback denominata MySystemDmaReceiveConfigureDmaChannel, usare il tipo di funzione EVT_SERCX2_SYSTEM_DMA_RECEIVE_CONFIGURE_DMA_CHANNEL, come illustrato in questo esempio di codice:
EVT_SERCX2_SYSTEM_DMA_RECEIVE_CONFIGURE_DMA_CHANNEL MySystemDmaReceiveConfigureDmaChannel;
Implementare quindi la funzione di callback come segue:
_Use_decl_annotations_
NTSTATUS
MySystemDmaReceiveConfigureDmaChannel(
SERCX2SYSTEMDMARECEIVE SystemDmaReceive,
PMDL Mdl,
ULONG Offset,
ULONG Length
)
{...}
Il tipo di funzione EVT_SERCX2_SYSTEM_DMA_RECEIVE_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_RECEIVE_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. |