функция обратного вызова PBUILD_MDL_FROM_SCATTER_GATHER_LIST (wdm.h)

Статья
08/08/2023

Подпрограмма BuildMdlFromScatterGatherList создает MDL из точечных и сборных списков, выделенных системой.

Эта подпрограмма зарезервирована для использования системой.

Синтаксис

PBUILD_MDL_FROM_SCATTER_GATHER_LIST PbuildMdlFromScatterGatherList;

NTSTATUS PbuildMdlFromScatterGatherList(
  [in]  PDMA_ADAPTER DmaAdapter,
  [in]  PSCATTER_GATHER_LIST ScatterGather,
  [in]  PMDL OriginalMdl,
  [out] PMDL *TargetMdl
)
{...}

Параметры

[in] DmaAdapter

Указатель на структуру DMA_ADAPTER, возвращаемую IoGetDmaAdapter, которая представляет адаптер master шины или контроллер DMA.

[in] ScatterGather

Указатель на структуру SCATTER_GATHER_LIST , переданную в подпрограмму AdapterListControl драйвера.

[in] OriginalMdl

Указатель на исходный MDL, который драйвер использовал для создания точечных и сборных списков.

[out] TargetMdl

Указатель на переменную, которую подпрограмма использует для возврата MDL, созданного для хранения буфера, описанного в списке точечной и сборной. Возвращаемое значение может совпадать с OriginalMdl.

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

BuildMdlFromScatterGatherList возвращает один из следующих кодов состояния:

Код возврата	Описание
STATUS_SUCCESS	Операция успешно выполнена.
STATUS_INVALID_PARAMETER	Параметр OriginalMdl имеет значение NULL.
STATUS_INSUFFICIENT_RESOURCES	Недостаточно памяти для выделения нового языка MDL.
STATUS_NONE_MAPPED	Система уже создала новый MDL для расположений памяти в списке точечной и сборной. (Это происходит только в том случае, если подпрограмма вызывается дважды в одном и том же списке точечной или сборной.)

BuildMdlFromScatterGatherList не является системной подпрограммой, которую можно вызывать напрямую по имени. Эта подпрограмма может вызываться только указателем из адреса, возвращаемого в DMA_OPERATIONS структуре. Драйверы получают адрес этой подпрограммы, вызывая IoGetDmaAdapter с элементом Version параметра DeviceDescription , равным DEVICE_DESCRIPTION_VERSION2. Если IoGetDmaAdapter возвращает значение NULL, подпрограмма недоступна на вашей платформе.

Когда драйвер создает список точечной или сборной для записи на устройство, система может создать копию записываемых данных и использовать ее для выполнения операции DMA. Используйте эту подпрограмму для доступа к расположениям памяти в списке точечной и сборной независимо от того, являются ли эти расположения копиями.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows XP и более поздних версиях Windows.
Целевая платформа	Персональный компьютер
Верхняя часть	wdm.h (включая Wdm.h)
IRQL	<= DISPATCH_LEVEL
Правила соответствия DDI	IrqlDispatch(wdm)