WdfDmaTransactionGetDevice, fonction (wdfdmatransaction.h)
[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) |