StorPortAllocateMdl 関数 (storport.h)

StorPortAllocateMdl ルーチンは、指定された非ページプールメモリを記述するために MDL を割り当てます。

構文

ULONG StorPortAllocateMdl(
  [in]  PVOID HwDeviceExtension,
  [in]  PVOID BufferPointer,
  [in]  ULONG NumberOfBytes,
  [out] PVOID *Mdl
);

[in] HwDeviceExtension

ホストバスアダプター (HBA) のハードウェアデバイス拡張機能へのポインター。

[in] BufferPointer

MDL が記述するバッファーのベース仮想アドレスへのポインター。

[in] NumberOfBytes

このパラメーターは、MDL が記述するバッファーの長さをバイト単位で指定します。

[out] Mdl

割り当てられた MDL を受け取るポインター。

StorPortAllocateMdl は、次のいずれかの状態コードを返します。

リターンコード	形容
STOR_STATUS_NOT_IMPLEMENTED	この関数は、アクティブなオペレーティングシステムでは実装されません。
STOR_STATUS_SUCCESS	ルーチンが MDL を正常に割り当てたことを示します。
STOR_STATUS_INVALID_PARAMETER	MDL を受け取るポインターは NULL 。バッファーへのポインターは NULL 。
STOR_STATUS_INVALID_IRQL	呼び出しが無効な IRQL で行われました。
STOR_STATUS_INSUFFICIENT_RESOURCES	指定されたバッファーを記述するために MDL を割り当てることができません。

ミニポートドライバーは、StorPortAllocateMdl ルーチンを呼び出して、非ページプールからのメモリブロックを記述する MDL を割り当てます。 MDL を解放するには、ミニポートドライバーは、StorPortFreeMdl ルーチンを呼び出します。