WdfDmaEnablerSetMaximumScatterGatherElements, fonction (wdfdmaenabler.h)

  • Article

[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)

Voir aussi

WdfDmaEnablerCreate

WdfDmaEnablerGetMaximumScatterGatherElements