共用方式為

LkmdTelCreateReport 函式 （lkmdtel.h）

  • 發行項

此函式會初始化新的即時核心傾印遙測報告，並將報表的不透明句柄傳回給呼叫端，以便與後續的 LkmdTel 函式搭配使用。

語法

HANDLE LkmdTelCreateReport(
  PWCHAR    ReportType,
  ULONG     BugCheckCode,
  ULONG_PTR BugCheckParam1,
  ULONG_PTR BugCheckParam2,
  ULONG_PTR BugCheckParam3,
  ULONG_PTR BugCheckParam4
);

參數

ReportType

此參數會定義報表類型字串。 例如，針對 xHCI，此值定義為 L“USBXHCI” 針對開發驅動程式集合的晶片合作夥伴，應該只使用一個 ReportType 字串。

報表類型名稱長度上限為16個Unicode字元，包括終止的NULL。

BugCheckCode

此值是核心實時傾印程序代碼。 例如，SoC 子系統重新啟動會使用 SOC_SUBSYSTEM_FAILURE_LIVEDUMP （0x15d）

BugCheckParam1

為每個元件定義，這會提供在傾印中設定的第一個參數。

BugCheckParam2

為每個元件定義，這會提供在傾印中設定的第二個參數。

BugCheckParam3

為每個元件定義，這會提供在傾印中設定的第三個參數。

BugCheckParam4

為每個元件定義，這會提供在傾印中設定的第四個參數。

傳回值

此函式會傳回遙測數據的不透明句柄，該數據可與 LkmdTelSubmitReport、LkmdTelSetSecondaryData和 LkmdTelInsertTriageDataBlock 函式搭配使用。 使用 LkmdTelCloseHandle關閉此句柄。

在失敗的情況下，句柄會傳回 NULL。

言論

  • 必須先呼叫此函式，因為它會配置用來儲存遙測數據的數據結構。 它會傳回遙測句柄。
  • Telemery 報表句柄會使用 LkmdTelCloseHandle關閉。

要求

要求 價值
標頭 lkmdtel.h
連結庫 lkmdtel.lib、\werkernelapi.lib
IRQL PASSIVE_LEVEL

另請參閱