WdfDmaTransactionWdmGetTransferContext, fonction (wdfdmatransaction.h)

[S’applique uniquement à KMDF]

La méthode WdfDmaTransactionWdmGetTransferContext récupère le contexte de transfert WDM associé à une transaction DMA.

Syntaxe

PVOID WdfDmaTransactionWdmGetTransferContext(
  [in] WDFDMATRANSACTION DmaTransaction
);

Paramètres

[in] DmaTransaction

Handle vers un objet de transaction DMA initialisé à partir duquel récupérer le contexte de transfert.

Valeur retournée

Pointeur vers le contexte de transfert DMA (PTRANSFER_CONTEXT) associé à la transaction.

Remarques

Le contexte de transfert DMA pour une transaction est alloué lorsque le pilote crée la transaction.

WdfDmaTransactionWdmGetTransferContext doit être utilisé avec un enabler DMA qui utilise DMA version 3. Pour sélectionner la version 3, définissez le membre WdmDmaVersionOverride de WDF_DMA_ENABLER_CONFIG sur 3.

Votre pilote peut utiliser le contexte de transfert DMA pour appeler directement les routines de bibliothèque WDM DMA suivantes :

• AllocateAdapterChannelEx
• CancelAdapterChannel
• CancelMappedTransfer
• GetScatterGatherListEx
• BuildScatterGatherListEx

Vous devez initialiser la transaction DMA avant d’appeler WdfDmaTransactionWdmGetTransferContext.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8
Plateforme cible	Universal
Version KMDF minimale	1.11
En-tête	wdfdmatransaction.h (inclure Wdf.h)
Bibliothèque	Wdf01000.sys (consultez Gestion de version de la bibliothèque d’infrastructure.)
IRQL	<=DISPATCH_LEVEL
Règles de conformité DDI	DriverCreate(kmdf)

Voir aussi

WdfDmaTransactionCreate