Функция 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);
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Универсальное |
| Минимальная версия KMDF | 1,0 |
| Верхняя часть | wdfdmaenabler.h (включая Wdf.h) |
| Библиотека | Wdf01000.sys (см. раздел Управление версиями библиотеки Платформы). |
| IRQL | <=DISPATCH_LEVEL |
| Правила соответствия DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |