Edytuj

Udostępnij za pośrednictwem

LkmdTelSetSecondaryData function (lkmdtel.h)

  • Artykuł

This function sets the secondary data in the telemetry data structure. It is not required prior to submitting a report. Providing secondary data allows a component to supply extra data within the minidump to assist in debugging.

Syntax

NTSTATUS LkmdTelSetSecondaryData(
  HANDLE  TelemetryHandle,
  LPCGUID SecondaryDataGuid,
  ULONG   SecondaryDataSize,
  PVOID   SecondaryDataBuffer
);

Parameters

TelemetryHandle

Supplies a telemetry handle created by LkmdTelCreateReport.

SecondaryDataGuid

This is the GUID used to define the secondary data in the minidump.

SecondaryDataSize

This is the size of the buffer for secondary data.

SecondaryDataBuffer

This is the secondary data buffer.

Return value

STATUS_SUCCESS if successful.

Remarks

  • This function can only be called one time per dump file. The buffer passed to this API must remain valid until after a call and return from LkmdTelSubmitReport.
  • The size of the data should be less than 24 MB, although the actual size may vary based on the Windows version or system configuration. Data that exceeds the limit will be truncated.
  • For more information, see Secondary callback data.

Requirements

Requirement Value
Header lkmdtel.h
Library lkmdtel.lib, \werkernelapi.lib
IRQL PASSIVE_LEVEL

See also

LkmdTelSubmitReport