WdfDmaTransactionSetChannelConfigurationCallback-Funktion (wdfdmatransaction.h)

Artikel
02/29/2024

[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:

Ruft WdfDmaTransactionInitializeUsingRequest, WdfDmaTransactionInitialize oder WdfDmaTransactionInitializeUsingOffset auf, um das Transaktionsobjekt zu initialisieren.
Ruft WdfDmaTransactionSetChannelConfigurationCallback für das Transaktionsobjekt auf.
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

Freigeben über