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)

Voir aussi

EvtInterruptDpc

WdfDmaTransactionCreate

WdfDmaTransactionDmaCompleted

WdfRequestCompleteWithInformation