WdfDmaEnablerGetMaximumScatterGatherElements, fonction (wdfdmaenabler.h)
[S’applique uniquement à KMDF]
La méthode WdfDmaEnablerGetMaximumScatterGatherElements retourne le nombre maximal d’éléments de diffusion/collecte pris en charge par l’appareil et le pilote, pour un objet d’activation DMA spécifié.
Syntaxe
size_t WdfDmaEnablerGetMaximumScatterGatherElements(
[in] WDFDMAENABLER DmaEnabler
);
Paramètres
[in] DmaEnabler
Handle pour un objet d’activation DMA que le pilote a obtenu à partir d’un appel précédent à WdfDmaEnablerCreate.
Valeur retournée
Si le pilote a précédemment appelé WdfDmaEnablerSetMaximumScatterGatherElements, WdfDmaEnablerGetMaximumScatterGatherElements retourne la valeur spécifiée par le pilote dans l’appel précédent. Sinon, WdfDmaEnablerGetMaximumScatterGatherElements retourne WDF_DMA_ENABLER_UNLIMITED_FRAGMENTS, ce qui indique qu’il n’y a pas de limite au nombre d’éléments scatter/collect.
Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.
Remarques
Pour plus d’informations sur cette méthode, consultez Activation des transactions DMA.
Exemples
L’exemple de code suivant obtient le nombre maximal d’éléments de diffusion/collecte pour un objet d’activation DMA spécifié.
size_t maxElements;
maxElements = WdfDmaEnablerGetMaximumScatterGatherElements(DmaEnabler);
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.0 |
| En-tête | wdfdmaenabler.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) |