共用方式為

PoFxPowerOnCrashdumpDevice 函式 (wdm.h)

  • 發行項

PoFxPowerOnCrashdumpDevice 例程會要求開啟損毀傾印裝置。

語法

NTSTATUS PoFxPowerOnCrashdumpDevice(
  [in]           POHANDLE Handle,
  [in, optional] PVOID    Context
);

參數

[in] Handle

句柄，表示向 Windows 電源管理架構 註冊損毀傾印裝置的句柄， (PoFx) 。 裝置驅動程式先前已從 PoFxRegisterDevice 例程收到此句柄。

[in, optional] Context

裝置特定內容的指標。 此指標會當做輸入參數傳遞至裝置的平臺擴充功能外掛程式所實作的 PowerOnDumpDeviceCallback 回 呼例程 (PEP) 。 內容資訊會以設備驅動器所定義的格式儲存，且由 PEP 瞭解。 此內容與操作系統不透明。 如果 PEP 不需要內容，驅動程式可以將此參數設定為 NULL。

傳回值

如果例程成功開啟裝置電源，PoFxPowerOnCrashdumpDevice 會傳回STATUS_SUCCESS。 可能的錯誤傳回值包括下列狀態代碼。

傳回值 描述
STATUS_INVALID_PARAMETER
 不是有效的句柄值。
STATUS_UNSUCCESSFUL
 此裝置的 PEP 不會實作 PowerOnDumpDeviceCallback 回 呼例程;或 PEP 無法開啟裝置。

備註

損毀傾印裝置的驅動程式會呼叫此例程，要求平臺擴充功能外掛程式 (PEP) 開啟裝置，以便儲存損毀傾印。 損毀傾印裝置鏈結中的所有裝置 (，其中可能包含記憶體控制器、PCI 控制器等等，必須先開啟) ，才能將損毀傾印檔案寫入磁碟。

如需損毀傾印的詳細資訊，請參閱 核心模式傾印檔案。

您可以在 IRQL <= HIGH_LEVEL呼叫此例程。

規格需求

需求 值
最低支援的用戶端 從 Windows 8.1 開始提供。
目標平台 Windows
標頭 wdm.h (包含 Pepfx.h)
程式庫 Ntoskrnl.lib
IRQL <= HIGH_LEVEL

另請參閱

PoFxRegisterDevice

PowerOnDumpDeviceCallback