Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[Gilt nur für KMDF]
Die WdfDmaEnablerGetMaximumScatterGatherElements Methode gibt die maximale Anzahl von Punkt/Gather-Elementen zurück, die vom Gerät und Treiber unterstützt werden, für ein angegebenes DMA-Enabler-Objekt.
Syntax
size_t WdfDmaEnablerGetMaximumScatterGatherElements(
[in] WDFDMAENABLER DmaEnabler
);
Die Parameter
[in] DmaEnabler
Ein Handle für ein DMA-Enabler-Objekt, das der Treiber aus einem vorherigen Aufruf von WdfDmaEnablerCreateabgerufen hat.
Rückgabewert
Wenn der Zuvor aufgerufene Treiber WdfDmaEnablerSetMaximumScatterGatherElements, WdfDmaEnablerGetMaximumScatterGatherElements den Wert zurück, den der im vorherigen Aufruf angegebene Treiber zurückgibt. Andernfalls gibt WdfDmaEnablerGetMaximumScatterGatherElements WDF_DMA_ENABLER_UNLIMITED_FRAGMENTS zurück, was angibt, dass es keine Beschränkung auf die Anzahl der Punkt-/Gatherelemente gibt.
Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.
Bemerkungen
Weitere Informationen zu dieser Methode finden Sie unter Aktivieren von DMA-Transaktionen.
Beispiele
Das folgende Codebeispiel ruft die maximale Anzahl von Punkt/Gather-Elementen für ein angegebenes DMA-Enabler-Objekt ab.
size_t maxElements;
maxElements = WdfDmaEnablerGetMaximumScatterGatherElements(DmaEnabler);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | universell |
| Minimale KMDF-Version | 1.0 |
| Kopfzeile | wdfdmaenabler.h (include Wdf.h) |
| Bibliothek | Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.) |
| IRQL | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |