You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
143 lines
4.4 KiB
143 lines
4.4 KiB
|
|
/*++
|
|
|
|
Copyright (c) 1990 Microsoft Corporation
|
|
|
|
Module Name:
|
|
|
|
kdextlib.h
|
|
|
|
Abstract:
|
|
|
|
Redirector Kernel Debugger extension
|
|
|
|
Author:
|
|
|
|
Balan Sethu Raman (SethuR) 11-May-1994
|
|
|
|
Revision History:
|
|
|
|
11-Nov-1994 SethuR Created
|
|
|
|
--*/
|
|
|
|
#ifndef _KDEXTLIB_H_
|
|
#define _KDEXTLIB_H_
|
|
|
|
//#include <windef.h>
|
|
|
|
//
|
|
// The FIELD_DESCRIPTOR data structure is used to describe the field in a structure sufficiently
|
|
// for displaying information during debugging. The three pieces of information that are required
|
|
// are 1) the name of the field, 2) the offset in the corresponding structure and 3) a type descriptor.
|
|
// The type descriptor covers most primitive types.
|
|
//
|
|
// The task of generating these descriptors by augmenting the front end, but that will have to
|
|
// wait till we play around with these extensions and modify the data structures to meet most
|
|
// of the requirements.
|
|
//
|
|
// There are some types that can benefit from some auxillary information in the descriptors. A
|
|
// case in point is the "enum" defeinition. Merely printing out a numerical value for an enum
|
|
// type will invariably force the person using these extensions to refer to the corresponding
|
|
// include file. In order to avoid this we will accept an additional array for enum types that
|
|
// contains a textual description of the numerical value.
|
|
//
|
|
// There are certain conventions that have been adopted to ease the definition of the macros
|
|
// as well as facilitate the automation of the generation of these descriptors.
|
|
// These are as follows ....
|
|
//
|
|
// 1) All ENUM_VALUE_DESCRIPTOR definitions are named EnumValueDescrsOf_ENUMTYPENAME, where
|
|
// ENUMTYPENAME defines the corresponding enumerated type.
|
|
//
|
|
|
|
typedef struct _ENUM_VALUE_DESCRIPTOR {
|
|
ULONG EnumValue;
|
|
LPSTR EnumName;
|
|
} ENUM_VALUE_DESCRIPTOR;
|
|
|
|
typedef enum _FIELD_TYPE_CLASS {
|
|
FieldTypeNone,
|
|
FieldTypeByte,
|
|
FieldTypeChar,
|
|
FieldTypeBoolean,
|
|
FieldTypeBool,
|
|
FieldTypeULong,
|
|
FieldTypeULongUnaligned,
|
|
FieldTypeULongFlags,
|
|
FieldTypeLong,
|
|
FieldTypeLongUnaligned,
|
|
FieldTypeUShort,
|
|
FieldTypeUShortUnaligned,
|
|
FieldTypeUShortFlags,
|
|
FieldTypeShort,
|
|
FieldTypePointer,
|
|
FieldTypeUnicodeString,
|
|
FieldTypeAnsiString,
|
|
FieldTypeSymbol,
|
|
FieldTypeEnum,
|
|
FieldTypeByteBitMask,
|
|
FieldTypeWordBitMask,
|
|
FieldTypeDWordBitMask,
|
|
FieldTypeFloat,
|
|
FieldTypeDouble,
|
|
FieldTypeStruct,
|
|
FieldTypeLargeInteger,
|
|
FieldTypeFileTime
|
|
} FIELD_TYPE_CLASS, *PFIELD_TYPE_CLASS;
|
|
|
|
typedef struct _FIELD_DESCRIPTOR_ {
|
|
FIELD_TYPE_CLASS FieldType; // The type of variable to be printed
|
|
LPSTR Name; // The name of the field
|
|
//USHORT Offset; // The offset of the field in the structure
|
|
LONG Offset; // The offset of the field in the structure
|
|
union {
|
|
ENUM_VALUE_DESCRIPTOR *pEnumValueDescriptor; // Auxillary information for enumerated types.
|
|
} AuxillaryInfo;
|
|
} FIELD_DESCRIPTOR;
|
|
|
|
#define FIELDLAST {FieldTypeNone, NULL, 0, NULL}
|
|
|
|
#define FIELD3(FieldType,StructureName, FieldName) \
|
|
{FieldType, #FieldName , FIELD_OFFSET(StructureName,FieldName) ,NULL}
|
|
|
|
#define FIELD4(FieldType, StructureName, FieldName, AuxInfo) \
|
|
{FieldType, #FieldName , FIELD_OFFSET(StructureName,FieldName) ,AuxInfo}
|
|
|
|
//
|
|
// The structs that are displayed by the debugger extensions are further
|
|
// described in another array. Each entry in the array contains the name of
|
|
// the structure and the associated Field descriptor list.
|
|
//
|
|
|
|
typedef struct _STRUCT_DESCRIPTOR_ {
|
|
LPSTR StructName;
|
|
ULONG StructSize;
|
|
ULONG EnumManifest;
|
|
FIELD_DESCRIPTOR *FieldDescriptors;
|
|
USHORT MatchMask;
|
|
USHORT MatchValue;
|
|
} STRUCT_DESCRIPTOR;
|
|
|
|
#define STRUCT(StructTypeName,FieldDescriptors,MatchMask,MatchValue) \
|
|
{ #StructTypeName,sizeof(StructTypeName), \
|
|
StrEnum_##StructTypeName, \
|
|
FieldDescriptors,MatchMask,MatchValue}
|
|
|
|
#define STRUCTLAST {NULL, 0, 0, NULL, 0, 0}
|
|
//
|
|
// The array of structs handled by the debugger extension.
|
|
//
|
|
|
|
extern STRUCT_DESCRIPTOR Structs[];
|
|
|
|
//
|
|
// Support for displaying global variables
|
|
//
|
|
|
|
extern LPSTR GlobalBool[];
|
|
extern LPSTR GlobalShort[];
|
|
extern LPSTR GlobalLong[];
|
|
extern LPSTR GlobalPtrs[];
|
|
|
|
#endif // _KDEXTLIB_H_
|
|
|