WdfDmaEnablerSetMaximumScatterGatherElements, fonction (wdfdmaenabler.h)

[S’applique uniquement à KMDF]

La méthode WdfDmaEnablerSetMaximumScatterGatherElements définit le nombre maximal d’éléments de nuage de points/de collecte qu’un appareil prend en charge, pour un objet d’activation DMA spécifié.

Syntaxe

void WdfDmaEnablerSetMaximumScatterGatherElements(
  [in] WDFDMAENABLER DmaEnabler,
  [in] size_t        MaximumFragments
);

Paramètres

[in] DmaEnabler

Handle vers un objet d’activation DMA que le pilote a obtenu à partir d’un appel précédent à WdfDmaEnablerCreate.

[in] MaximumFragments

Nombre maximal d’éléments de nuages/de collecte que le pilote et l’appareil peuvent prendre en charge.

Valeur de retour

Aucun

Remarques

Une vérification de bogue se produit si le pilote fournit un handle d’objet non valide.

Si votre pilote appelle WdfDmaEnablerSetMaximumScatterGatherElements, il doit le faire dans la fonction EvtDriverDeviceAdd ou EvtDevicePrepareHardware fonction de rappel.

Si votre pilote n’appelle pas WdfDmaEnablerSetMaximumScatterGatherElements, l’infrastructure utilise une valeur par défaut de WDF_DMA_ENABLER_UNLIMITED_FRAGMENTS, ce qui signifie qu’il n’existe aucune limite au nombre d’éléments de nuages de points/collecte.

Pour plus d’informations sur cette méthode, consultez Activation des transactions DMA.

Exemples

L’exemple de code suivant définit le nombre maximal d’éléments de nuages de points/de collecte pour un objet d’activation DMA spécifié.

WdfDmaEnablerSetMaximumScatterGatherElements(
                                             DmaEnabler, 
                                             NIC_MAX_PHYS_BUF_COUNT
                                             );

Spécifications

Besoin	Valeur
plateforme cible	Universel
version minimale de KMDF	1.0
En-tête	wdfdmaenabler.h (include Wdf.h)
Bibliothèque	Wdf01000.sys (voir Versioning de la bibliothèque Framework.)
IRQL	PASSIVE_LEVEL
règles de conformité DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

WdfDmaEnablerCreate

WdfDmaEnablerGetMaximumScatterGatherElements