Функция MmPrepareMdlForReuse (wdm.h)

Статья
02/07/2025

Макрос MmPrepareMdlForReuse освобождает ресурсы, связанные с частичным MDL, чтобы MDL можно было использовать повторно.

Синтаксис

void MmPrepareMdlForReuse(
  [in] PMDL MDL
);

Параметры

[in] MDL

Указатель на частичный MDL, который должен быть готов к повторному использованию.

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

Никакой

Замечания

Этот макрос используется драйверами, которые многократно используют один и тот же выделенный MDL для параметра TargetMdl в вызовах подпрограммы IoBuildPartialMdl. Если при вызове MmPrepareMdlForReuseуказанный частичный MDL имеет связанное сопоставление с адресным пространством системы, MmPrepareMdlForReuse освобождает сопоставление, чтобы MDL можно было повторно использовать.

MmPrepareMdlForReuse принимает только частичные многомерные выражения, созданные IoBuildPartialMdl. Если MmPrepareMdlForReuse получает MDL, сопоставленный с адресным пространством системы, но не был создан IoBuildPartialMdl, MmPrepareMdlForReuse не освобождает сопоставление.

Дополнительные сведения о частичных многомерных выражениях см. в разделе Использование многомерных выражений.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000
заголовка	wdm.h
IRQL	<= DISPATCH_LEVEL
правил соответствия DDI	MdlAfterReqCompletedIntIoctlA(kmdf), MdlAfterReqCompletedIoctlA(kmdf), MdlAfterReqCompletedReadA(kmdf), MdlAfterReqCompletedWriteA(kmdf)

Поделиться через