Skip to content

Latest commit

 

History

History
278 lines (207 loc) · 5.77 KB

ns-wdbgexts-_dbgkd_get_version64.md

File metadata and controls

278 lines (207 loc) · 5.77 KB
Raw
UID title description old-location tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames f1_keywords topic_type api_type api_location api_name
NS:wdbgexts._DBGKD_GET_VERSION64
_DBGKD_GET_VERSION64 (wdbgexts.h)
The IG_GET_KERNEL_VERSION Ioctl operation receives information related to the operating system version of the target.
debugger\ig_get_kernel_version.htm
debugger
05/03/2018
DBGKD_GET_VERSION64 structure
*PDBGKD_GET_VERSION64, DBGKD_GET_VERSION64, DBGKD_GET_VERSION64 structure [Windows Debugging], PDBGKD_GET_VERSION64, PDBGKD_GET_VERSION64 structure pointer [Windows Debugging], WdbgExts_Ref_33e7f185-3831-439b-9e92-8d942627f66b.xml, _DBGKD_GET_VERSION64, debugger.ig_get_kernel_version, wdbgexts/DBGKD_GET_VERSION64, wdbgexts/PDBGKD_GET_VERSION64
wdbgexts.h
Wdbgexts.h, Dbgeng.h
Windows
Windows
DBGKD_GET_VERSION64, *PDBGKD_GET_VERSION64
_DBGKD_GET_VERSION64
wdbgexts/_DBGKD_GET_VERSION64
PDBGKD_GET_VERSION64
wdbgexts/PDBGKD_GET_VERSION64
DBGKD_GET_VERSION64
wdbgexts/DBGKD_GET_VERSION64
APIRef
kbSyntax
HeaderDef
wdbgexts.h
_DBGKD_GET_VERSION64
PDBGKD_GET_VERSION64
DBGKD_GET_VERSION64

_DBGKD_GET_VERSION64 structure

-description

The IG_GET_KERNEL_VERSION Ioctl operation receives information related to the operating system version of the target. When calling Ioctl with IoctlType set to IG_GET_KERNEL_VERSION, IpvData should contain an instance of the DBGKD_GET_VERSION64 structure.

-struct-fields

-field MajorVersion

Receives 0xF if the target's operating system is a free build, and 0xC if it is a checked build.

-field MinorVersion

Receives the build number for the target's operating system.

-field ProtocolVersion

Receives the version of the debugger protocol that is used to communicate between the debugger and the target.

-field KdSecondaryVersion

Receives a secondary version number that is used to distinguish among older, deprecated contexts.

-field Flags

Receives a set of bit flags for the current debugging session. The following flags can be present.

Flag Meaning when set
DBGKD_VERS_FLAG_MP The target kernel was compiled with support for multiple processors.
DBGKD_VERS_FLAG_DATA The list DebuggerDataList is valid.
DBGKD_VERS_FLAG_PTR64 The target uses 64-bit pointers.
DBGKD_VERS_FLAG_NOMM The debugger's memory cache is active. If this is not set, the debugger will convert all virtual addresses into physical address before accessing the target's memory.
DBGKD_VERS_FLAG_HSS The target supports hardware stepping.
DBGKD_VERS_FLAG_PARTITIONS Multiple operating system partitions exist.

-field MachineType

Receives the type of the target's processor. Possible processor types are listed in the following table.

Value Processor
IMAGE_FILE_MACHINE_I386 x86 architecture
IMAGE_FILE_MACHINE_ARM ARM architecture
IMAGE_FILE_MACHINE_IA64 Intel Itanium architecture
IMAGE_FILE_MACHINE_AMD64 x64 architecture
IMAGE_FILE_MACHINE_EBC EFI byte code architecture

-field MaxPacketType

Receives one plus the highest number for a debugger packet type recognized by the target.

-field MaxStateChange

Receives one plus the highest number for a state change generated by the target.

-field MaxManipulate

Receives one more that the highest number, recognized by the target, for a command to manipulate the target.

-field Simulation

Receives an indication if the target is in simulated execution. Possible values are listed in the following table.

Value Processor
DBGKD_SIMULATION_NONE No simulation is used.
DBGKD_SIMULATION_EXDI EXDI simulation is used.

-field Unused

Unused.

-field KernBase

Receives the base address of the kernel image.

-field PsLoadedModuleList

Receives the value of the kernel variable PsLoadedModuleList.

-field DebuggerDataList

Receives the value of the kernel variable KdDebuggerDataBlock. This a pointer to either a KDDEBUGGER_DATA64 structure or a KDDEBUGGER_DATA32 structure. Use the function GetDebuggerData to fetch this structure.

-remarks

The parameters for the IG_GET_KERNEL_VERSION Ioctl operation are the members of the DBGKD_GET_VERSION64 structure.

This operation is only available in kernel-mode debugging.

-see-also

GetDebuggerData

Ioctl