WdfDmaTransactionWdmGetTransferContext-Funktion (wdfdmatransaction.h)

[Gilt nur für KMDF]

Die WdfDmaTransactionWdmGetTransferContext-Methode ruft den WDM-Übertragungskontext ab, der einer DMA-Transaktion zugeordnet ist.

Syntax

PVOID WdfDmaTransactionWdmGetTransferContext(
  [in] WDFDMATRANSACTION DmaTransaction
);

Parameter

[in] DmaTransaction

Ein Handle für ein initialisiertes DMA-Transaktionsobjekt, aus dem der Übertragungskontext abgerufen werden soll.

Rückgabewert

Ein Zeiger auf den der Transaktion zugeordneten DMA-Übertragungskontext (PTRANSFER_CONTEXT).

Hinweise

Der DMA-Übertragungskontext für eine Transaktion wird zugeordnet, wenn der Treiber die Transaktion erstellt.

WdfDmaTransactionWdmGetTransferContext muss mit einem DMA-Enabler verwendet werden, der DMA-Version 3 verwendet. Um Version 3 auszuwählen, legen Sie den WdmDmaVersionOverride-Member von WDF_DMA_ENABLER_CONFIG auf 3 fest.

Ihr Treiber kann den DMA-Übertragungskontext verwenden, um die folgenden WDM DMA-Bibliotheksroutinen direkt aufzurufen:

• AllocateAdapterChannelEx
• CancelAdapterChannel
• CancelMappedTransfer
• GetScatterGatherListEx
• BuildScatterGatherListEx

Sie müssen die DMA-Transaktion initialisieren, bevor Sie WdfDmaTransactionWdmGetTransferContext aufrufen.

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

WdfDmaTransactionCreate