Compartir a través de

Función LkmdTelCreateReport (lkmdtel.h)

  • Artículo

Esta función inicializa un nuevo informe de telemetría de volcado de kernel activo y devuelve un identificador opaco del informe al autor de la llamada para usarlo con las funciones LkmdTel posteriores.

Sintaxis

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

Parámetros

ReportType

Este parámetro define la cadena de tipo de informe. Por ejemplo, para xHCI, este valor se define como L"USBXHCI". Para un asociado de Silicon que desarrolle una colección de controladores, solo se debe usar una cadena ReportType.

La longitud máxima del nombre del tipo de informe es de 16 caracteres Unicode, incluida la terminación NULL.

BugCheckCode

Este valor es el código de volcado en vivo del kernel. Por ejemplo, el reinicio del subsistema soC usaría SOC_SUBSYSTEM_FAILURE_LIVEDUMP (0x15d)

BugCheckParam1

Definido por componente, esto proporciona el primer parámetro que se va a establecer en el volcado de memoria.

BugCheckParam2

Definido por componente, esto proporciona el segundo parámetro que se va a establecer en el volcado de memoria.

BugCheckParam3

Definido por componente, esto proporciona el tercer parámetro que se va a establecer en el volcado de memoria.

BugCheckParam4

Definido por componente, esto proporciona el cuarto parámetro que se va a establecer en el volcado de memoria.

Valor devuelto

Esta función devuelve un identificador opaco a los datos de telemetría que se pueden usar con las funciones LkmdTelSubmitReport, LkmdTelSetSecondaryDatay LkmdTelInsertTriageDataBlock. Este identificador se cierra mediante LkmdTelCloseHandle.

En caso de error, el identificador devuelve NULL.

Observaciones

  • En primer lugar, se debe llamar a esta función, ya que asigna la estructura de datos utilizada para almacenar los datos de telemetría. Devuelve el identificador de telemetría.
  • El identificador de informe de telemería se cierra mediante LkmdTelCloseHandle.

Requisitos

Requisito Valor
encabezado de lkmdtel.h
biblioteca de lkmdtel.lib, \werkernelapi.lib
irQL PASSIVE_LEVEL

Consulte también