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"로 정의됩니다. 드라이버 컬렉션을 개발하는 실리콘 파트너의 경우 하나의 ReportType 문자열만 사용해야 합니다.

최대 보고서 형식 이름 길이는 종료 NULL을 포함하여 16개의 유니코드 문자입니다.

BugCheckCode

이 값은 커널 라이브 덤프 코드입니다. 예를 들어 SoC 하위 시스템 다시 시작은 SOC_SUBSYSTEM_FAILURE_LIVEDUMP(0x15d)를 사용합니다.

BugCheckParam1

구성 요소별로 정의된 이 매개 변수는 덤프에 설정할 첫 번째 매개 변수를 제공합니다.

BugCheckParam2

구성 요소별로 정의되며 덤프에 설정할 두 번째 매개 변수를 제공합니다.

BugCheckParam3

구성 요소별로 정의되며 덤프에 설정할 세 번째 매개 변수를 제공합니다.

BugCheckParam4

구성 요소별로 정의된 이 매개 변수는 덤프에 설정할 네 번째 매개 변수를 제공합니다.

반환 값

이 함수는 LkmdTelSubmitReport, LkmdTelSetSecondaryData및 LkmdTelInsertTriageDataBlock 함수와 함께 사용할 수 있는 원격 분석 데이터에 대한 불투명 핸들을 반환합니다. 이 핸들은 LkmdTelCloseHandle사용하여 닫힙니다.

오류가 발생할 경우 핸들은 NULL반환합니다.

발언

• 이 함수는 원격 분석 데이터를 저장하는 데 사용되는 데이터 구조를 할당하므로 먼저 호출해야 합니다. 원격 분석 핸들을 반환합니다.
• Telemery Report 핸들은 LkmdTelCloseHandle사용하여 닫힙니다.

요구 사항

요구	값
헤더	lkmdtel.h
라이브러리	lkmdtel.lib, \werkernelapi.lib
IRQL	PASSIVE_LEVEL

참고 항목

• LkmdTelSubmitReport
• LkmdTelSetSecondaryData
• LkmdTelInsertTriageDataBlock
• LkmdTelCloseHandle