WdfDmaTransactionGetBytesTransferred, fonction (wdfdmatransaction.h)
[S’applique uniquement à KMDF]
La méthode WdfDmaTransactionGetBytesTransferred retourne le nombre total d’octets qui ont été transférés pour une transaction DMA spécifiée.
Syntaxe
size_t WdfDmaTransactionGetBytesTransferred(
[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
WdfDmaTransactionGetBytesTransferred retourne le nombre total d’octets qui ont été transférés pour la transaction DMA spécifiée par le paramètre DmaTransaction .
Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.
Remarques
Les pilotes basés sur l’infrastructure appellent généralement WdfDmaTransactionGetBytesTransferred à partir d’une fonction de rappel d’événement EvtInterruptDpc , une fois tous les transferts DMA terminés, pour obtenir le nombre final d’octets transférés. Les pilotes utilisent généralement le nombre d’octets final comme entrée dans la méthode WdfRequestCompleteWithInformation . Pour plus d’informations sur cette méthode, consultez Achèvement d’une transaction DMA.
Exemples
Pour obtenir un exemple de code qui utilise WdfDmaTransactionGetBytesTransferred, consultez WdfDmaTransactionDmaCompleted.
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 de version de la bibliothèque d’infrastructure.) |
| IRQL | <=DISPATCH_LEVEL |
| Règles de conformité DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |