CONTEXTRECORD

CONTEXTRECORD

Machine specific register contents for the thread at the time of the exception.

Type

ULONG ContextFlags
ULONG ctx_env[7]
FPREG ctx_stack[8]
ULONG ctx_SegGs
ULONG ctx_SegFs
ULONG ctx_SegEs
ULONG ctx_SegDs
ULONG ctx_RegEdi
ULONG ctx_RegEsi
ULONG ctx_RegEax
ULONG ctx_RegEbx
ULONG ctx_RegEcx
ULONG ctx_RegEdx
ULONG ctx_RegEbp
ULONG ctx_RegEip
ULONG ctx_SegCs
ULONG ctx_EFlags
ULONG ctx_RegEsp
ULONG ctx_SegSs

C Declaration Method

typedef struct

Fields

ContextFlags Flags which control the contents of the context record. 
             Possible values are shown in the following list: 
             * CONTEXT_CONTROL SS:ESP, CS:EIP, EFLAGS and EBP 
             * CONTEXT_INTEGER EAX, EBX, ECX, EDX, ESI and EDI 
             * CONTEXT_SEGMENTS DS, ES, FS, and GS 
             * CONTEXT_FLOATING_POINT numeric coprocessor state
             * CONTEXT_FULL all the above.
              
             If the context record is used as an input parameter, then for each      
             portion of the context record controlled by a flag whose value is
             set, it is assumed that the portion of the context record contains
             valid context. If the context record is being used to modify a
             thread's context, then only that portion of the thread's context
             will be modified. 

             If the context record is used as an input/output parameter to
             capture the context of a thread, then only those portions of the
             thread's context corresponding to set flags will be returned.

ctx_env[7]   This parameter is used only when ContextFlags is set to
             CONTEXT_FLOATING_POINT.

ctx_stack[8] This parameter is used only when ContextFlags is set to 
             CONTEXT_FLOATING_POINT. 
 
ctx_SegGs    GS register.
             This parameter is used only when ContextFlags is set to 
             CONTEXT_SEGMENTS.

ctx_SegFs    FS register.
             This parameter is used only when ContextFlags is set to
             CONTEXT_SEGMENTS.

ctx_SegEs    ES register.
             This parameter is used only when ContextFlags is set to
             CONTEXT_SEGMENTS.

ctx_SegDs    DS register.
             This parameter is used only when ContextFlags is set to
             CONTEXT_SEGMENTS. 
 
ctx_RegEdi   EDI register.
             This parameter is used only when ContextFlags is set to 
             CONTEXT_INTEGER.

ctx_RegEsi   ESI register.
             This parameter is used only when ContextFlags is set to
             CONTEXT_INTEGER.

ctx_RegEax   EAX register.
             This parameter is used only when ContextFlags is set to
             CONTEXT_INTEGER.

ctx_RegEbx   EBX register.
             This parameter is used only when ContextFlags is set to
             CONTEXT_INTEGER.
  
ctx_RegEcx   ECX register.
             This parameter is used only when ContextFlags is set to
             CONTEXT_INTEGER. 
 
ctx_RegEdx   EDX register.
             This parameter is used only when ContextFlags is set to 
             CONTEXT_INTEGER.

ctx_RegEbp   EBP register.
             This parameter is used only when ContextFlags is set to 
             CONTEXT_CONTROL.

ctx_RegEip   EIP register.
             This parameter is used only when ContextFlags is set to
             CONTEXT_CONTROL. 
 
ctx_SegCs    CS register.
             This parameter is used only when ContextFlags is set to 
             CONTEXT_CONTROL.

ctx_EFlags   EFLAGS register.
             This parameter is used only when ContextFlags is set to 
             CONTEXT_CONTROL.

ctx_RegEsp   ESP register.
             This parameter is used only when ContextFlags is set to 
             CONTEXT_CONTROL.

ctx_SegSs    SS register.
             This parameter is used only when ContextFlags is set to 
             CONTEXT_CONTROL.

Comment

Note that only the register sets specified by ContextFlags contain valid data. Conversely, only registers specified in ContextFlags will be restored if an exception is handled.