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_BLOCK 或 STORAGE_REQUEST_BLOCK。
[in] Mdl
要求 Pfns 之 MDL 的指標。 僅支援使用 StorPortGetOriginalMdl 或 StorPortGetDataInBufferMdl 取得的 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 |