Funzione WdfDmaTransactionSetChannelConfigurationCallback (wdfdmatransaction.h)

  • Articolo

[Si applica solo a KMDF]

Il metodo WdfDmaTransactionSetChannelConfigurationCallback registra una funzione di callback dell'evento di configurazione del canale per una transazione DMA in modalità sistema.

Sintassi

void WdfDmaTransactionSetChannelConfigurationCallback(
  [in]           WDFDMATRANSACTION                             DmaTransaction,
  [in, optional] PFN_WDF_DMA_TRANSACTION_CONFIGURE_DMA_CHANNEL ConfigureRoutine,
  [in, optional] PVOID                                         ConfigureContext
);

Parametri

[in] DmaTransaction

Handle a un oggetto transazione DMA inizializzato per cui impostare o cancellare il callback della configurazione del canale.

[in, optional] ConfigureRoutine

Puntatore alla funzione di callback dell'evento EvtDmaTransactionConfigureDmaChannel o NULL del driver.

[in, optional] ConfigureContext

Puntatore a un buffer contenente il contesto da fornire alla funzione di callback dell'evento EvtDmaTransactionConfigureDmaChannel o NULL del driver.

Valore restituito

nessuno

Osservazioni

Questo metodo consente al driver di personalizzare la configurazione dell'adattatore prima di programmare il controller DMA di sistema.

In genere dall'interno di una funzione di callback dell'evento di I/O, un driver esegue i passaggi seguenti, in questo ordine:

  1. Chiama WdfDmaTransactionInitializeUsingRequest, WdfDmaTransactionInitialize o WdfDmaTransactionInitializeUsingOffset per inizializzare l'oggetto transazioni.
  2. Chiama WdfDmaTransactionSetChannelConfigurationCallback nell'oggetto transazioni.
  3. Chiama WdfDmaTransactionExecute.
Se il driver ha specificato una funzione di callback dell'evento EvtDmaTransactionConfigureDmaChannel chiamando WdfDmaTransactionSetChannelConfigurationCallback e il driver chiama successivamente WdfDmaTransactionRelease, il callback viene cancellato.

WdfDmaTransactionSetChannelConfigurationCallback deve essere usato con un enabler DMA che specifica un profilo DMA in modalità sistema.

Se il driver chiama questo metodo in un sistema operativo precedente a Windows 8, il verificatore del framework segnala un errore.

Requisiti

Requisito Valore
Client minimo supportato Windows 8
Piattaforma di destinazione Universale
Versione KMDF minima 1.11
Intestazione wdfdmatransaction.h (include Wdf.h)
Libreria Wdf01000.sys (vedere Framework Library Versioning).
IRQL <=DISPATCH_LEVEL
Regole di conformità DDI DriverCreate(kmdf)

Vedi anche

EvtDmaTransactionConfigureDmaChannel

WdfDmaTransactionRelease