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 :

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

Configuration requise

   
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 (voir Gestion des versions de la bibliothèque Framework.)
IRQL <=DISPATCH_LEVEL
Règles de conformité DDI DriverCreate(kmdf)

Voir aussi

WdfDmaTransactionCreate