Freigeben über

WdfDmaTransactionSetChannelConfigurationCallback-Funktion (wdfdmatransaction.h)

[Gilt nur für KMDF]

Die WdfDmaTransactionSetChannelConfigurationCallback Methode registriert eine Kanalkonfigurationsereignisrückruffunktion für eine DMA-Transaktion im Systemmodus.

Syntax

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

Die Parameter

[in] DmaTransaction

Ein Handle für ein initialisiertes DMA-Transaktionsobjekt, für das der Kanalkonfigurationsrückruf festgelegt oder gelöscht werden soll.

[in, optional] ConfigureRoutine

Ein Zeiger auf die EvtDmaTransactionConfigureDmaChannel Ereignisrückruffunktion oder NULL, um ihn zu löschen.

[in, optional] ConfigureContext

Ein Zeiger auf einen Puffer, der den Kontext enthält, der für die EvtDmaTransactionConfigureDmaChannel des Treibers bereitgestellt werden soll, Ereignisrückruffunktion oder NULL.

Rückgabewert

Nichts

Bemerkungen

Mit dieser Methode kann der Treiber die Adapterkonfiguration anpassen, bevor der DMA-Controller des Systems programmiert wird.

In der Regel innerhalb einer E/A-Ereignisrückruffunktionführt ein Treiber die folgenden Schritte in dieser Reihenfolge aus:

  1. Ruft WdfDmaTransactionInitializeUsingRequest, WdfDmaTransactionInitializeoder WdfDmaTransactionInitializeUsingOffset auf, um das Transaktionsobjekt zu initialisieren.
  2. Ruft WdfDmaTransactionSetChannelConfigurationCallback- für das Transaktionsobjekt auf.
  3. Ruft WdfDmaTransactionExecuteauf.
Wenn der Treiber eine EvtDmaTransactionConfigureDmaChannel Ereignisrückruffunktion angegeben hat, indem WdfDmaTransactionSetChannelConfigurationCallback aufgerufen wird und der Treiber anschließend WdfDmaTransactionReleaseaufruft, wird der Rückruf gelöscht.

WdfDmaTransactionSetChannelConfigurationCallback- muss mit einem DMA-Enabler verwendet werden, der ein DMA-Profil im Systemmodus angibt.

Wenn Ihr Treiber diese Methode auf einem Früheren Betriebssystem als Windows 8 aufruft, meldet der Überprüfung des Frameworks einen Fehler.

Anforderungen

Anforderung Wert
Unterstützter Client (Mindestversion) Windows 8
Zielplattform universell
Minimale KMDF-Version 1.11
Kopfzeile wdfdmatransaction.h (include Wdf.h)
Bibliothek Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.)
IRQL <=DISPATCH_LEVEL
DDI-Complianceregeln DriverCreate(kmdf)

Siehe auch

EvtDmaTransactionConfigureDmaChannel

WdfDmaTransactionRelease