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

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

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

Синтаксис

size_t WdfDmaEnablerGetMaximumScatterGatherElements(
  [in] WDFDMAENABLER DmaEnabler
);

Параметры

[in] DmaEnabler

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

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

Если драйвер ранее вызывался WdfDmaEnablerSetMaximumScatterGatherElements, WdfDmaEnablerGetMaximumScatumScatterGatherElements возвращает значение, указанное в предыдущем вызове. В противном случае WdfDmaEnablerGetMaximumScatterGatherElements возвращает WDF_DMA_ENABLER_UNLIMITED_FRAGMENTS, что указывает, что число элементов точечной и сборной не ограничено.

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

Замечания

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

Примеры

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

size_t maxElements;

maxElements = WdfDmaEnablerGetMaximumScatterGatherElements(DmaEnabler);
 

Требования

См. также

WdfDmaEnablerCreate

WdfDmaEnablerSetMaximumScatterGatherElements