Condividi tramite

Funzione LkmdTelCreateReport (lkmdtel.h)

  • Articolo

Questa funzione inizializza un nuovo report di telemetria del dump del kernel live e restituisce un handle opaco del report al chiamante da usare con le funzioni LkmdTel successive.

Sintassi

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

Parametri

ReportType

Questo parametro definisce la stringa del tipo di report. Ad esempio, per xHCI, questo valore viene definito come L"USBXHCI". Per un partner Silicon che sviluppa una raccolta di driver, è necessario usare una sola stringa ReportType.

La lunghezza massima del nome del tipo di report è di 16 caratteri Unicode, inclusa la terminazione NULL.

BugCheckCode

Questo valore è il codice di dump live del kernel. Ad esempio, il riavvio del sottosistema SoC userà SOC_SUBSYSTEM_FAILURE_LIVEDUMP (0x15d)

BugCheckParam1

Definito per componente, fornisce il primo parametro da impostare nel dump.

BugCheckParam2

Definito per componente, fornisce il secondo parametro da impostare nel dump.

BugCheckParam3

Definito per componente, fornisce il terzo parametro da impostare nel dump.

BugCheckParam4

Definito per componente, fornisce il quarto parametro da impostare nel dump.

Valore restituito

Questa funzione restituisce un handle opaco ai dati di telemetria che possono essere usati con le funzioni LkmdTelSubmitReport, LkmdTelSetSecondaryDatae funzioni LkmdTelInsertTriageDataBlock. Questo handle viene chiuso usando LkmdTelCloseHandle.

In caso di errore, l'handle restituisce NULL.

Osservazioni

  • Questa funzione deve essere chiamata per prima, poiché alloca la struttura dei dati usata per archiviare i dati di telemetria. Restituisce l'handle di telemetria.
  • L'handle report di telemery viene chiuso usando LkmdTelCloseHandle.

Fabbisogno

Requisito Valore
intestazione lkmdtel.h
libreria lkmdtel.lib, \werkernelapi.lib
IRQL PASSIVE_LEVEL

Vedere anche