Freigeben über


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:

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