Freigeben über

LkmdTelCreateReport-Funktion (lkmdtel.h)

  • Artikel

Diese Funktion initialisiert einen neuen Live-Kernel-Dump-Telemetriebericht und gibt einen undurchsichtigen Handle des Berichts an den Aufrufer zurück, der für die Verwendung mit nachfolgenden LkmdTel-Funktionen verwendet werden kann.

Syntax

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

Parameter

ReportType

Dieser Parameter definiert die Berichtstypzeichenfolge. Für xHCI wird dieser Wert beispielsweise als "L"USBXHCI" definiert. Für einen Silicon-Partner, der eine Sammlung von Treibern entwickelt, sollte nur eine ReportType- Zeichenfolge verwendet werden.

Die maximale Länge des Berichtstyps beträgt 16 Unicode-Zeichen, einschließlich der endenden NULL.

BugCheckCode

Dieser Wert ist der Kernel-Liveabbildcode. SoC-Subsystemneustart würde z. B. SOC_SUBSYSTEM_FAILURE_LIVEDUMP (0x15d) verwenden.

BugCheckParam1

Definiert pro Komponente stellt dies den ersten Parameter bereit, der im Dump festgelegt werden soll.

BugCheckParam2

Definiert pro Komponente stellt dies den zweiten Parameter bereit, der im Dump festgelegt werden soll.

BugCheckParam3

Definiert pro Komponente stellt dies den dritten Parameter bereit, der im Dump festgelegt werden soll.

BugCheckParam4

Definiert pro Komponente stellt dies den vierten Parameter bereit, der im Dump festgelegt werden soll.

Rückgabewert

Diese Funktion gibt einen undurchsichtigen Handle für die Telemetriedaten zurück, die mit den funktionen LkmdTelSubmitReport, LkmdTelSetSecondaryDataund LkmdTelInsertTriageDataBlock verwendet werden können. Dieser Handle wird mit LkmdTelCloseHandlegeschlossen.

Im Falle eines Fehlers gibt das Handle NULL-zurück.

Bemerkungen

  • Diese Funktion muss zuerst aufgerufen werden, da sie die Zum Speichern der Telemetriedaten verwendete Datenstruktur zuordnet. Der Telemetriepunkt wird zurückgegeben.
  • Der Telemery Report Handle wird mit LkmdTelCloseHandlegeschlossen.

Anforderungen

Anforderung Wert
Header- lkmdtel.h
Library lkmdtel.lib, \werkernelapi.lib
IRQL- PASSIVE_LEVEL

Siehe auch