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