WdfDmaEnablerGetMaximumScatterGatherElements-Funktion (wdfdmaenabler.h)

[Gilt nur für KMDF]

Die WdfDmaEnablerGetMaximumScatterGatherElements-Methode gibt die maximale Anzahl von Scatter-/Gather-Elementen zurück, die das Gerät und der Treiber für ein angegebenes DMA-Enabler-Objekt unterstützen.

Syntax

size_t WdfDmaEnablerGetMaximumScatterGatherElements(
  [in] WDFDMAENABLER DmaEnabler
);

Parameter

[in] DmaEnabler

Ein Handle für ein DMA-Enabler-Objekt, das der Treiber von einem vorherigen Aufruf von WdfDmaEnablerCreate abgerufen hat.

Rückgabewert

Wenn der Treiber zuvor WdfDmaEnablerSetMaximumScatterGatherElements aufgerufen hat, gibt WdfDmaEnablerGetMaximumScatterGatherElements den Wert zurück, den der Treiber im vorherigen Aufruf angegeben hat. Andernfalls gibt WdfDmaEnablerGetMaximumScatterGatherElements WDF_DMA_ENABLER_UNLIMITED_FRAGMENTS zurück, was angibt, dass die Anzahl von Scatter-/Gather-Elementen nicht begrenzt ist.

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Hinweise

Weitere Informationen zu dieser Methode finden Sie unter Aktivieren von DMA-Transaktionen.

Beispiele

Im folgenden Codebeispiel wird die maximale Anzahl von Scatter-/Gather-Elementen für ein angegebenes DMA-Aktivierungsobjekt abgerufen.

size_t maxElements;

maxElements = WdfDmaEnablerGetMaximumScatterGatherElements(DmaEnabler);
 

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1.0
Kopfzeile	wdfdmaenabler.h (einschließen von Wdf.h)
Bibliothek	Wdf01000.sys (siehe Versionierung der Frameworkbibliothek.)
IRQL	<=DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Weitere Informationen

WdfDmaEnablerCreate

WdfDmaEnablerSetMaximumScatterGatherElements