Share via


IeXdi2ClientNotifyRunChg::NotifyRunStateChange (Windows Embedded CE 6.0)

1/5/2010

This method notifies the client application of a change in the run state.

Syntax

HRESULT NotifyRunStateChange(
  [in] RUN_STATUS_TYPE2 ers2Current,
  [in] DWORD dwNbOfHaltReasons,
  [in, size_is (dwNbOfHaltReasons)] HALT_REASON_TYPE2 * pehr2List,
  [in] ADDRESS_TYPE CurrentExecAddress,
  [in] DWORD64 dw64CycleSinceLastRun
);

Parameters

  • ersCurrent
    Run status type.
  • dwNbOfHaltReasons
    Number of halt reasons provided in pehr2List.
  • pehr2List
    Pointer to the list of all reasons for halting execution.

    If none, or if not a halt, the pointer to the list should be NULL.

  • CurrentExecAddress
    If run status is halted, indicates the address of current program or instruction pointer; otherwise, undefined.
  • dwExceptionCode
    Type and source of exception, if halted due to an exception. Undefined otherwise.

    Exception code is architecture dependant.

  • dw64CycleSinceLastRun
    Number of clock cycles executed after the target resumed execution.

Return Value

The following table shows return values for this method.

Value Description

S_OK

Indicates the function was successful.

E_FAIL

Indicates an unspecified failure.

Requirements

Header eXDI2.h
Library ole32.lib, oleaut32.lib
Windows Embedded CE Windows CE 5.0 and later

See Also

Reference

IeXdi2ClientNotifyRunChg
IeXDI2 Interfaces