MmPrepareMdlForReuse 関数 (wdm.h)

MmPrepareMdlForReuse は、部分的な MDL に関連付けられているリソースを解放して、MDL を再利用できるようにするマクロです。

構文

void MmPrepareMdlForReuse(
  [in] PMDL MDL
);

パラメーター

[in] MDL

再利用できるように準備する部分的な MDL へのポインター。

戻り値

なし

解説

このマクロは、IoBuildPartialMdl ルーチンの呼び出しで TargetMdl パラメーターとして同じ割り当て済み MDL を繰り返し使用するドライバーで使用します。 MmPrepareMdlForReuse の呼び出しで、指定した部分的な MDL に、システム アドレス空間に対するマッピングが関連付けられている場合、MmPrepareMdlForReuse によってマッピングが解放され、MDL を再利用できるようになります。

MmPrepareMdlForReuse では、IoBuildPartialMdlによって作成された部分的な MDL のみが受け入れられます。 MmPrepareMdlForReuse に、システム アドレス空間にマップされているが IoBuildPartialMdl によって作成されていない MDL が渡された場合、MmPrepareMdlForReuse によってマッピングは解放さません。

部分的な MDL の詳細については、「MDL の使用」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000
Header	wdm.h
IRQL	<= DISPATCH_LEVEL
DDI コンプライアンス規則	MdlAfterReqCompletedIntIoctlA(kmdf)、 MdlAfterReqCompletedIoctlA(kmdf)、 MdlAfterReqCompletedReadA(kmdf)、 MdlAfterReqCompletedWriteA(kmdf)