Função LkmdTelCreateReport (lkmdtel.h)
Essa função inicializa um novo relatório de telemetria de despejo de kernel dinâmico e retorna uma alça opaca do relatório para o chamador para uso com funções LkmdTel subsequentes.
Sintaxe
HANDLE LkmdTelCreateReport(
PWCHAR ReportType,
ULONG BugCheckCode,
ULONG_PTR BugCheckParam1,
ULONG_PTR BugCheckParam2,
ULONG_PTR BugCheckParam3,
ULONG_PTR BugCheckParam4
);
Parâmetros
ReportType
Esse parâmetro define a cadeia de caracteres de tipo de relatório. Por exemplo, para xHCI, esse valor é definido como L"USBXHCI". Para um parceiro de Silício que desenvolve uma coleção de drivers, apenas uma cadeia de ReportType deve ser usada.
O comprimento máximo do nome do tipo de relatório é de 16 caracteres Unicode, incluindo o NULL de encerramento.
BugCheckCode
Esse valor é o código de despejo dinâmico do kernel. Por exemplo, a reinicialização do subsistema SoC usaria SOC_SUBSYSTEM_FAILURE_LIVEDUMP (0x15d)
BugCheckParam1
Definido por componente, isso fornece o primeiro parâmetro a ser definido no despejo.
BugCheckParam2
Definido por componente, isso fornece o segundo parâmetro a ser definido no despejo.
BugCheckParam3
Definido por componente, isso fornece o terceiro parâmetro a ser definido no despejo.
BugCheckParam4
Definido por componente, isso fornece o quarto parâmetro a ser definido no despejo.
Valor de retorno
Essa função retorna uma alça opaca para os dados de telemetria que podem ser usados com as funções LkmdTelSubmitReport, LkmdTelSetSecondaryDatae LkmdTelInsertTriageDataBlock. Esse identificador é fechado usando LkmdTelCloseHandle.
No caso de falha, o identificador retorna NULL.
Observações
- Essa função deve ser chamada primeiro, pois aloca a estrutura de dados usada para armazenar os dados de telemetria. Ele retorna o identificador de telemetria.
- O identificador de relatório telemery é fechado usando LkmdTelCloseHandle.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | lkmdtel.h |
| biblioteca | lkmdtel.lib, \werkernelapi.lib |
| IRQL | PASSIVE_LEVEL |