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 de retour

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

Remarques

Le contexte de transfert DMA d’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 DMA WDM suivantes :

• AllocateAdapterChannelEx
• CancelAdapterChannel
• CancelMappedTransfer
• GetScatterGatherListEx
• BuildScatterGatherListEx

Spécifications

Voir aussi

WdfDmaTransactionCreate