WdfDmaTransactionSetChannelConfigurationCallback-Funktion (wdfdmatransaction.h)

  • Artikel

[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
);

Parameter

[in] DmaTransaction

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

[in, optional] ConfigureRoutine

Ein Zeiger auf die EvtDmaTransactionConfigureDmaChannel-Ereignisrückruffunktion des Treibers oder NULL, um sie zu löschen.

[in, optional] ConfigureContext

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

Rückgabewert

Keine

Bemerkungen

Mit dieser Methode kann der Treiber die Adapterkonfiguration anpassen, bevor er den System-DMA-Controller programmiert.

In der Regel führt ein Treiber in einer E/A-Warteschlangenereignisrückruffunktion die folgenden Schritte in dieser Reihenfolge aus:

  1. Ruft WdfDmaTransactionInitializeUsingRequest, WdfDmaTransactionInitialize oder WdfDmaTransactionInitializeUsingOffset auf, um das Transaktionsobjekt zu initialisieren.
  2. Ruft WdfDmaTransactionSetChannelConfigurationCallback für das Transaktionsobjekt auf.
  3. Ruft WdfDmaTransactionExecute auf.
Wenn der Treiber eine EvtDmaTransactionConfigureDmaChannel-Ereignisrückruffunktion angegeben hat, indem er WdfDmaTransactionSetChannelConfigurationCallback aufruft und der Treiber anschließend WdfDmaTransactionRelease aufruft, 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 unter einem Betriebssystem vor Windows 8 aufruft, meldet die Überprüfung des Frameworks einen Fehler.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8
Zielplattform Universell
KMDF-Mindestversion 1.11
Kopfzeile wdfdmatransaction.h (einschließen von Wdf.h)
Bibliothek Wdf01000.sys (siehe Versionierung der Frameworkbibliothek.)
IRQL <=DISPATCH_LEVEL
DDI-Complianceregeln DriverCreate(kmdf)

Weitere Informationen

EvtDmaTransactionConfigureDmaChannel

WdfDmaTransactionRelease