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 會傳回下列其中一個狀態代碼：

傳回碼	Description
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 例程。