WdfDmaEnablerSetMaximumScatterGatherElements-Funktion (wdfdmaenabler.h)

  • Artikel

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

Weitere Informationen

WdfDmaEnablerCreate

WdfDmaEnablerGetMaximumScatterGatherElements