共用方式為

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

傳回碼 描述
STOR_STATUS_SUCCESS 表示例程已成功設定單位屬性。
STOR_STATUS_INVALID_PARAMETER Flags 參數中指定了無效的旗標值。

言論

StorPortMarkDumpMemory 例程只能由迷你埠驅動程式在其 DriverEntry 或 HwStorFindAdapter 例程中呼叫。

如果 Length = 0，則會標示包含 Address 的整個區段。

Miniport 驅動程式應該呼叫 StorPortMarkDumpMemory，以確保迷你埠用來產生傾印檔案或休眠檔案的記憶體已識別。 當 DumpModePORT_CONFIGURATION_INFORMATION 成員設定為 DUMP_MODE_MARK_MEMORY 或 DUMP_MODE_HIBER時，迷你埠至少應該呼叫 storPortMarkDumpMemory。

要求

要求 價值
最低支援的用戶端 Windows 8
目標平臺 普遍
標頭 storport.h （包括 Storport.h）
IRQL 任何

另請參閱

DriverEntry

HwStorFindAdapter

PORT_CONFIGURATION_INFORMATION