Функция WdfDmaEnablerSetMaximumScatterGatherElements (wdfdmaenabler.h)

[Применяется только к KMDF]

Метод WdfDmaEnablerSetMaximumScatterGatherElements задает максимальное количество элементов точечной и сборной, поддерживаемых устройством, для указанного объекта enabler DMA.

Синтаксис

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

Параметры

[in] DmaEnabler

Дескриптор объекта включения DMA, полученного драйвером при предыдущем вызове WdfDmaEnablerCreate.

[in] MaximumFragments

Максимальное число элементов точечной и сборной, которое может поддерживать драйвер и устройство.

Возвращаемое значение

None

Remarks

Ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Если драйвер вызывает WdfDmaEnablerSetMaximumScatterGatherElements, он должен сделать это в функции обратного вызова EvtDriverDeviceAdd или EvtDevicePrepareHardware .

Если драйвер не вызывает WdfDmaEnablerSetMaximumScatterGatherElements, платформа использует значение по умолчанию WDF_DMA_ENABLER_UNLIMITED_FRAGMENTS, что означает, что нет ограничений на количество элементов точечной и сборной.

Дополнительные сведения об этом методе см. в разделе Включение транзакций DMA.

Примеры

В следующем примере кода задается максимальное число элементов точечной и сборной для указанного объекта средства включения DMA.

WdfDmaEnablerSetMaximumScatterGatherElements(
                                             DmaEnabler, 
                                             NIC_MAX_PHYS_BUF_COUNT
                                             );

Требования

См. также раздел

WdfDmaEnablerCreate

WdfDmaEnablerGetMaximumScatterGatherElements