Freigeben über


MmPrepareMdlForReuse-Funktion (wdm.h)

Das MmPrepareMdlForReuse-Makro gibt die Ressourcen frei, die einer partiellen MDL zugeordnet sind, damit die MDL wiederverwendet werden kann.

Syntax

void MmPrepareMdlForReuse(
  [in] PMDL MDL
);

Parameter

[in] MDL

Ein Zeiger auf eine partielle MDL, die für die Wiederverwendung vorbereitet werden soll.

Rückgabewert

Keine

Bemerkungen

Dieses Makro wird von Treibern verwendet, die wiederholt dieselbe zugeordnete MDL für den TargetMdl-Parameter in Aufrufen der IoBuildPartialMdl-Routine verwenden. Wenn bei einem Aufruf von MmPrepareMdlForReuse die angegebene partielle MDL über eine zuordnung zum Systemadressraum verfügt, gibt MmPrepareMdlForReuse die Zuordnung frei, sodass die MDL wiederverwendet werden kann.

MmPrepareMdlForReuse akzeptiert nur partielle MDLs, die von IoBuildPartialMdl erstellt werden. Wenn MmPrepareMdlForReuse eine MDL empfängt, die dem Systemadressraum zugeordnet ist, aber nicht von IoBuildPartialMdl erstellt wurde, gibt MmPrepareMdlForReuse die Zuordnung nicht frei.

Weitere Informationen zu partiellen MDLs finden Sie unter Verwenden von MDLs.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000
Kopfzeile wdm.h
IRQL <= DISPATCH_LEVEL
DDI-Complianceregeln MdlAfterReqCompletedIntIoctlA(kmdf), MdlAfterReqCompletedIoctlA(kmdf), MdlAfterReqCompletedReadA(kmdf), MdlAfterReqCompletedWriteA(kmdf)