共用方式為


StorPortGetPfns 函式 (storport.h)

迷你埠可以呼叫 StorPortGetPfns,以擷取與 SRB 相關聯之指定 MDL(記憶體描述元清單)所描述之內存的頁面框架號碼(Pfns)。

語法

ULONG StorPortGetPfns(
  [in]  PVOID               HwDeviceExtension,
  [in]  PSCSI_REQUEST_BLOCK Srb,
  [in]  PVOID               Mdl,
  [out] PVOID               *Pfns,
  [out] ULONG               *PfnCount,
  [out] ULONG               *StartingOffset
);

參數

[in] HwDeviceExtension

硬體裝置延伸模組的指標。 這是埠驅動程式代表迷你埠驅動程式配置和初始化的每個 HBA 儲存區域。

迷你埠驅動程式通常會在此延伸模組中儲存 HBA 特定資訊,例如 HBA 的狀態和 HBA 的對應存取範圍。 迷你埠驅動程式 DeviceExtension->HwDeviceExtension miniport 驅動程式會在迷你埠驅動程式呼叫 StorPortInitialize之後,立即取得 HBA 的迷你埠驅動程式。 埠驅動程式會在移除裝置時釋放此記憶體。

[in] Srb

來源 SCSI 要求區塊的指標(SRB)。 從 Windows 8 開始,Srb 參數可以指向 SCSI_REQUEST_BLOCKSTORAGE_REQUEST_BLOCK

[in] Mdl

要求 Pfns 之 MDL 的指標。 僅支援使用 StorPortGetOriginalMdlStorPortGetDataInBufferMdl 取得的 MDL。

[out] Pfns

與 MDL 相關聯之 Pfns 陣列的指標。 呼叫端不得修改、更新或釋放清單。

[out] PfnCount

陣列中 Pfns 指向的 Pfns 數目。

[out] StartingOffset

指定指定 MDL 所描述之緩衝區初始頁面內的位元移。

傳回值

StorPortGetPfns 會傳回下列其中一個狀態代碼:

傳回碼 描述
STOR_STATUS_NOT_IMPLEMENTED 此函式不會在作用中的操作系統上實作。
STOR_STATUS_SUCCESS 函式已順利完成。
STOR_STATUS_INVALID_PARAMETER 其中一個參數的指標 NULL

要求

要求 價值
目標平臺 普遍
標頭 storport.h

另請參閱

StorPortGetDataInBufferMdl

StorPortGetOriginalMdl

StorPortInitialize