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)

Voir aussi

WdfDmaEnablerCreate

WdfDmaEnablerSetMaximumScatterGatherElements