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 zu einem initialisierten DMA-Transaktionsobjekt, aus dem der Übertragungskontext abgerufen werden soll.

Rückgabewert

Ein Zeiger auf den DMA-Übertragungskontext (PTRANSFER_CONTEXT), der der Transaktion zugeordnet ist.

Bemerkungen

Der DMA-Übertragungskontext für eine Transaktion wird zugewiesen, 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 das WdmDmaVersionOverride-Element 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

   
Unterstützte Mindestversion (Client) Windows 8
Zielplattform Universell
KMDF-Mindestversion 1.11
Kopfzeile wdfdmatransaction.h (include Wdf.h)
Bibliothek Wdf01000.sys (siehe Framework-Bibliotheksversioning.)
IRQL <=DISPATCH_LEVEL
DDI-Complianceregeln DriverCreate(kmdf)

Siehe auch

WdfDmaTransactionCreate