通过

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”。 对于开发驱动程序集合的 Silicon 合作伙伴，应仅使用一个 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

另请参阅