WdfDmaTransactionGetTransferInfo, fonction (wdfdmatransaction.h)
[S’applique à KMDF uniquement]
La méthode WdfDmaTransactionGetTransferInfo retourne le nombre de registres de carte et d’entrées de liste de nuages de points/regroupements requis pour une transaction DMA initialisée.
Syntaxe
void WdfDmaTransactionGetTransferInfo(
[in] WDFDMATRANSACTION DmaTransaction,
[out, optional] ULONG *MapRegisterCount,
[out, optional] ULONG *ScatterGatherElementCount
);
Paramètres
[in] DmaTransaction
Handle pour un objet de transaction DMA initialisé.
[out, optional] MapRegisterCount
Emplacement fourni par l’appelant qui, au retour, contient le nombre de registres de carte requis pour la transaction spécifiée. Ce paramètre est facultatif et peut être NULL.
[out, optional] ScatterGatherElementCount
Emplacement fourni par l’appelant qui, au retour, contient le nombre d’éléments de nuages de points/regroupements requis pour la transaction spécifiée. Ce paramètre est facultatif et peut être NULL.
Valeur de retour
None
Remarques
Le pilote peut appeler WdfDmaTransactionGetTransferInfo avant d’appeler WdfDmaTransactionAllocateResources ou WdfDmaTransactionExecute.
Lorsque vous utilisez DMA version 3, cette méthode retourne un nombre précis de registres cartographiques nécessaires. Lors de l’utilisation de versions antérieures de DMA, cette méthode part du principe que chaque page nécessite un registre cartographique.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.11 |
| 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) |