WdfDmaEnablerSetMaximumScatterGatherElements, fonction (wdfdmaenabler.h)
[S’applique uniquement à KMDF]
La méthode WdfDmaEnablerSetMaximumScatterGatherElements définit le nombre maximal d’éléments de diffusion/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 pour 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 diffusion/collecte que le pilote et l’appareil peuvent prendre en charge.
Valeur de retour
None
Remarques
Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.
Si votre pilote appelle WdfDmaEnablerSetMaximumScatterGatherElements, il doit le faire dans la fonction de rappel EvtDriverDeviceAdd ou EvtDevicePrepareHardware .
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’y a aucune limite au nombre d’éléments de diffusion/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 diffusion/collecte pour un objet d’activation DMA spécifié.
WdfDmaEnablerSetMaximumScatterGatherElements(
DmaEnabler,
NIC_MAX_PHYS_BUF_COUNT
);
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 | PASSIVE_LEVEL |
| Règles de conformité DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |