Partager via

LkmdTelCreateReport, fonction (lkmdtel.h)

  • Article

Cette fonction initialise un nouveau rapport de télémétrie de vidage de noyau actif et retourne un handle opaque du rapport à l’appelant pour une utilisation avec les fonctions LkmdTel suivantes.

Syntaxe

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

Paramètres

ReportType

Ce paramètre définit la chaîne de type de rapport. Par exemple, pour xHCI, cette valeur est définie comme L « USBXHCI ». Pour un partenaire Silicon développant une collection de pilotes, une seule chaîne ReportType doit être utilisée.

La longueur maximale du nom du type de rapport est de 16 caractères Unicode, y compris la valeur NULL de fin.

BugCheckCode

Cette valeur est le code de vidage dynamique du noyau. Par exemple, le redémarrage du sous-système SoC utilise SOC_SUBSYSTEM_FAILURE_LIVEDUMP (0x15d)

BugCheckParam1

Défini par composant, il fournit le premier paramètre à définir dans le vidage.

BugCheckParam2

Défini par composant, il fournit le deuxième paramètre à définir dans le vidage.

BugCheckParam3

Défini par composant, il fournit le troisième paramètre à définir dans le vidage.

BugCheckParam4

Défini par composant, cela fournit le quatrième paramètre à définir dans le vidage.

Valeur de retour

Cette fonction retourne un handle opaque aux données de télémétrie qui peuvent être utilisées avec les fonctions LkmdTelSubmitReport, LkmdTelSetSecondaryDataet LkmdTelInsertTriageDataBlock. Ce handle est fermé à l’aide de LkmdTelCloseHandle.

En cas d’échec, le handle retourne null.

Remarques

  • Cette fonction doit être appelée en premier, car elle alloue la structure de données utilisée pour stocker les données de télémétrie. Elle retourne le handle de télémétrie.
  • Le handle de rapport Telemery est fermé à l’aide de LkmdTelCloseHandle.

Exigences

Exigence Valeur
d’en-tête lkmdtel.h
bibliothèque lkmdtel.lib, \werkernelapi.lib
IRQL PASSIVE_LEVEL

Voir aussi