Edit

Share via

KBUGCHECK_SECONDARY_DUMP_DATA structure (wdm.h)

  • Article

The KBUGCHECK_SECONDARY_DUMP_DATA structure describes a section of driver-supplied data to be written by KbCallbackSecondaryDumpData routine to the crash dump file.

Syntax

typedef struct _KBUGCHECK_SECONDARY_DUMP_DATA {
  IN PVOID  InBuffer;
  IN ULONG  InBufferLength;
  IN ULONG  MaximumAllowed;
  OUT GUID  Guid;
  OUT PVOID OutBuffer;
  OUT ULONG OutBufferLength;
} KBUGCHECK_SECONDARY_DUMP_DATA, *PKBUGCHECK_SECONDARY_DUMP_DATA;

Members

InBuffer

Pointer to a buffer that is allocated by the system.

InBufferLength

Specifies the size of the buffer, in bytes, specified by the InBuffer member.

MaximumAllowed

Specifies the maximum amount of data that the KbCallbackSecondaryDumpData routine can write to the crash dump file.

Guid

Specifies a GUID that identifies the driver's crash dump data. (Drivers must use unique GUIDs to mark their crash dump data. Use the GuidGen.exe tool to generate GUIDs for your driver. This tool is included in the Microsoft Windows SDK.)

OutBuffer

Pointer to the buffer where the driver writes its crash dump data, or NULL.

OutBufferLength

Specifies the size of the buffer, in bytes, that was specified by the OutBuffer member.

Remarks

For more information about how this structure is used, see Writing a Bug Check Callback Routine and KBUGCHECK_REASON_CALLBACK_ROUTINE callback function.

Requirements

Requirement Value
Minimum supported client Available on Microsoft Windows XP with Service Pack 1 (SP1), Windows Server 2003, and later versions of the Windows operating system.
Header wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

See also

Writing a Bug Check Callback Routine.