WdfDmaTransactionWdmGetTransferContext, fonction (wdfdmatransaction.h)

  • Article

[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 :

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