WdfDmaEnablerSetMaximumScatterGatherElements-Funktion (wdfdmaenabler.h)

[Gilt nur für KMDF]

Die WdfDmaEnablerSetMaximumScatterGatherElements- Methode legt die maximale Anzahl von Punkt/Gather-Elementen fest, die ein Gerät unterstützt, für ein angegebenes DMA-Enabler-Objekt.

Syntax

VOID WdfDmaEnablerSetMaximumScatterGatherElements(
  [in] WDFDMAENABLER DmaEnabler,
  [in] size_t        MaximumFragments
);

Die Parameter

[in] DmaEnabler

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

[in] MaximumFragments

Die maximale Anzahl von Punkt/Gather-Elementen, die vom Treiber und Gerät unterstützt werden können.

Rückgabewert

Nichts

Bemerkungen

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

Wenn Ihr Treiber WdfDmaEnablerSetMaximumScatterGatherElementsaufruft, muss dies innerhalb der EvtDriverDeviceAdd oder EvtDevicePrepareHardware Rückruffunktion erfolgen.

Wenn Ihr Treiber WdfDmaEnablerSetMaximumScatterGatherElementsnicht aufruft, verwendet das Framework einen Standardwert von WDF_DMA_ENABLER_UNLIMITED_FRAGMENTS, was bedeutet, dass es keine Beschränkung auf die Anzahl der Punkt/Gather-Elemente gibt.

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

Beispiele

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

WdfDmaEnablerSetMaximumScatterGatherElements(
                                             DmaEnabler, 
                                             NIC_MAX_PHYS_BUF_COUNT
                                             );

Anforderungen

Siehe auch

WdfDmaEnablerCreate

WdfDmaEnablerGetMaximumScatterGatherElements