Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
[S’applique uniquement à KMDF]
La méthode WdfDmaEnablerGetMaximumScatterGatherElements retourne le nombre maximal d’éléments de nuage de points/collecte pris en charge par le périphérique et le pilote pour un objet d’activation DMA spécifié.
Syntaxe
size_t WdfDmaEnablerGetMaximumScatterGatherElements(
[in] WDFDMAENABLER DmaEnabler
);
Paramètres
[in] DmaEnabler
Handle vers un objet d’activation DMA que le pilote a obtenu à partir d’un appel précédent à WdfDmaEnablerCreate.
Valeur de retour
Si le pilote a précédemment appelé WdfDmaEnablerSetMaximumScatterGatherElements, WdfDmaEnablerGetMaximumScatterGatherElements retourne la valeur spécifiée dans l’appel précédent. Sinon, WdfDmaEnablerGetMaximumScatterGatherElements retourne WDF_DMA_ENABLER_UNLIMITED_FRAGMENTS, ce qui indique qu’il n’existe aucune limite au nombre d’éléments de nuages de points/collecte.
Une vérification de bogue 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 nuages de points/de collecte pour un objet d’activation DMA spécifié.
size_t maxElements;
maxElements = WdfDmaEnablerGetMaximumScatterGatherElements(DmaEnabler);
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 | <=DISPATCH_LEVEL |
| règles de conformité DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |