WdfDmaTransactionGetDevice, fonction (wdfdmatransaction.h)

  • Article

[S’applique à KMDF uniquement]

La méthode WdfDmaTransactionGetDevice retourne un handle à l’objet d’appareil d’infrastructure associé à une transaction DMA spécifiée.

Syntaxe

WDFDEVICE WdfDmaTransactionGetDevice(
  [in] WDFDMATRANSACTION DmaTransaction
);

Paramètres

[in] DmaTransaction

Handle pour un objet de transaction DMA que le pilote a obtenu à partir d’un appel précédent à WdfDmaTransactionCreate.

Valeur retournée

WdfDmaTransactionGetDevice retourne un handle à l’objet de périphérique d’infrastructure que le pilote a spécifié quand il a appelé WdfDmaTransactionCreate.

Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.

Remarques

Pour plus d’informations sur l’exécution des transferts DMA, consultez Achèvement d’un transfert DMA.

Exemples

L’exemple de code suivant obtient un handle pour l’objet d’appareil framework associé à une transaction DMA spécifiée.

WDFDEVICE device;

device = WdfDmaTransactionGetDevice(DmaTransaction);

Configuration requise

Condition requise Valeur
Plateforme cible Universal
Version KMDF minimale 1.0
En-tête wdfdmatransaction.h (inclure Wdf.h)
Bibliothèque Wdf01000.sys (consultez Gestion des versions de la bibliothèque d’infrastructure).)
IRQL <=DISPATCH_LEVEL
Règles de conformité DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

WdfDmaTransactionCreate