Поделиться через

Функция 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 символов Юникода, включая завершающий значение NULL.

BugCheckCode

Это значение является кодом динамического дампа ядра. Например, перезапуск подсистемы SoC будет использовать SOC_SUBSYSTEM_FAILURE_LIVEDUMP (0x15d)

BugCheckParam1

Определяется для каждого компонента, он предоставляет первый параметр, заданный в дампах.

BugCheckParam2

Определяется для каждого компонента, он предоставляет второй параметр для задания в дампах.

BugCheckParam3

Определяется для каждого компонента, который предоставляет третий параметр, заданный в дампах.

BugCheckParam4

Определяется для каждого компонента, он предоставляет четвертый параметр, заданный в дампах.

Возвращаемое значение

Эта функция возвращает непрозрачный дескриптор данных телеметрии, которые можно использовать с LkmdTelSubmitReport, LkmdTelSetSecondaryDataи функции LkmdTelInsertTriageDataBlock. Этот дескриптор закрыт с помощью LkmdTelCloseHandle.

В случае сбоя дескриптор возвращает NULL.

Замечания

  • Эта функция должна вызываться сначала, так как она выделяет структуру данных, используемую для хранения данных телеметрии. Он возвращает дескриптор телеметрии.
  • Дескриптор отчета телемерии закрыт с помощью LkmdTelCloseHandle.

Требования

Требование Ценность
заголовка lkmdtel.h
библиотеки lkmdtel.lib, \werkernelapi.lib
IRQL PASSIVE_LEVEL

См. также