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 任何

另請參閱

DriverEntry

HwStorFindAdapter

PORT_CONFIGURATION_INFORMATION