StorPortMarkDumpMemory 函式 (storport.h)
迷你埠應該標示用於傾印檔案或休眠檔案的記憶體。 標示的記憶體會保留,並在從休眠作業繼續之後保持有效。 要標記的記憶體是由 對 StorPortMarkDumpMemory 呼叫中的位址和範圍長度所指定。
語法
ULONG StorPortMarkDumpMemory(
[in] PVOID HwDeviceExtension,
[in] PVOID Address,
[in] ULONG_PTR Length,
[in] ULONG Flags
);
參數
[in] HwDeviceExtension
主機總線適配卡的硬體裝置擴充功能指標, (HBA) 。
[in] Address
要標記之內存範圍的起始位址。
[in] Length
標示記憶體範圍的長度。
[in] Flags
傾印記憶體標記旗標。 Flags 參數必須是 0,或只包含下列值。
值 | 意義 |
---|---|
MARK_DUMP_MEMORY_FLAG_PHYSICAL_ADDRESS | 位址中提供的地址是實體位址,而不是系統虛擬位址。 |
傳回值
StorPortMarkDumpMemory 會傳回下列其中一個狀態代碼:
傳回碼 | Description |
---|---|
STOR_STATUS_SUCCESS | 表示例程已成功設定單位屬性。 |
STOR_STATUS_INVALID_PARAMETER | Flags 參數中指定了無效的旗標值。 |
備註
StorPortMarkDumpMemory 例程只能由其 DriverEntry 或 HwStorFindAdapter 例程中的迷你埠驅動程式呼叫。
如果 Length = 0,則會標示包含 Address 的整個區段。
迷你埠驅動程序應該呼叫 StorPortMarkDumpMemory ,以確保迷你埠用來產生傾印檔案或休眠檔案的記憶體已識別。 當 PORT_CONFIGURATION_INFORMATION 的 DumpMode 成員設定為 DUMP_MODE_MARK_MEMORY 或 DUMP_MODE_HIBER 時,迷你埠應該呼叫 StorPortMarkDumpMemory。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8 |
目標平台 | Universal |
標頭 | storport.h (包含 Storport.h) |
IRQL | 任何 |