WdfDmaEnablerSetMaximumScatterGatherElements-Funktion (wdfdmaenabler.h)
[Gilt nur für KMDF]
Die WdfDmaEnablerSetMaximumScatterGatherElements-Methode legt die maximale Anzahl von Scatter-/Gather-Elementen fest, die ein Gerät für ein angegebenes DMA-Enabler-Objekt unterstützt.
Syntax
void WdfDmaEnablerSetMaximumScatterGatherElements(
[in] WDFDMAENABLER DmaEnabler,
[in] size_t MaximumFragments
);
Parameter
[in] DmaEnabler
Ein Handle für ein DMA-Enabler-Objekt, das der Treiber von einem vorherigen Aufruf von WdfDmaEnablerCreate abgerufen hat.
[in] MaximumFragments
Die maximale Anzahl von Scatter-/Gather-Elementen, die der Treiber und das Gerät unterstützen können.
Rückgabewert
Keine
Bemerkungen
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Wenn Ihr Treiber WdfDmaEnablerSetMaximumScatterGatherElements aufruft, muss dies innerhalb der Rückruffunktion EvtDriverDeviceAdd oder EvtDevicePrepareHardware erfolgen.
Wenn Ihr Treiber WdfDmaEnablerSetMaximumScatterGatherElements nicht aufruft, verwendet das Framework den Standardwert WDF_DMA_ENABLER_UNLIMITED_FRAGMENTS, was bedeutet, dass die Anzahl der Scatter-/Gather-Elemente nicht begrenzt ist.
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 festgelegt.
WdfDmaEnablerSetMaximumScatterGatherElements(
DmaEnabler,
NIC_MAX_PHYS_BUF_COUNT
);
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 | PASSIVE_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |