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

Die Parameter

[in] DmaTransaction

Ein Handle für ein initialisiertes 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 einer DMA-Aktivierung verwendet werden, die DMA Version 3 verwendet. Um Version 3 auszuwählen, legen Sie den WdmDmaVersionOverride Mitglied 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-

Anforderungen

Siehe auch

WdfDmaTransactionCreate