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

[Относится только к KMDF]

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

Синтаксис

size_t WdfDmaEnablerGetMaximumScatterGatherElements(
  [in] WDFDMAENABLER DmaEnabler
);

Параметры

[in] DmaEnabler

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

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

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

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

Комментарии

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

Примеры

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

size_t maxElements;

maxElements = WdfDmaEnablerGetMaximumScatterGatherElements(DmaEnabler);
 

Требования

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

WdfDmaEnablerCreate

WdfDmaEnablerSetMaximumScatterGatherElements