Share via


IOsAxsExec::EnumDataBpsInAddrRange (Windows Embedded CE 6.0)

1/5/2010

This method creates an enumeration list of instantiated data breakpoints whose addresses are within a given range and returns a pointer to its interface.

Syntax

HRESULT EnumDataBpsInAddrRangeByProcAndThd(
  DWORD ProcID,
  DWORD ThdID,
  MEM_TYPE2 mt2,
  ADDRESS_TYPE FirstAddress,
  ADDRESS_TYPE LastAddress,
  TRISTATE_TYPE f3Enabled,
  IeXdi2EnumDataBp** ppieXdi2EnumDataBp
);

Parameters

  • ProcID
    [in] Identifier of the process of interest.

    This value is 0 if the list includes all processes within the range or if no process of interest is identified.

  • ThdID
    [in] Identifier of the thread of interest.

    This value is 0 if the list includes all threads within the range or if no thread of interest is identified.

  • mt2
    [in] Data memory type that indicates whether this memory address concerns one of the following:

    • Virtual memory
    • Physical memory
    • Peripheral I/O with the mtContext value not accepted
  • FirstAddress
    [in] First address of the filtering address range.
  • LastAddress
    [in] Last address of the filtering address range.
  • f3Enabled
    [in] Flag that identifies a specified breakpoint in the list as TRISTATE_TYPE. The type value must be one of the following:

    • Enabled
    • Disabled
    • Not important
  • ppieXdi2EnumDataBp
    [out] Pointer to the object interface of the newly created enumeration list.

Return Value

The following table shows return values for this method.

Value Description

S_OK

Indicates the function was successful and all breakpoints were created.

E_FAIL

Indicates an unspecified failure.

E_NORESAVAILABLE

Indicates a breakpoint resource was not available and the method could not instantiate all breakpoints.

E_OUTOFMEMORY

Indicates an out of memory error.

E_INVALIDARG

Indicates one or more invalid arguments.

EXDI_E_COMMUNICATION

Indicates a communication error between host driver and debugging target.

Requirements

Header OsAccess.h
Library OSAXSC.lib
Windows Embedded CE Windows CE 5.0 and later

See Also

Reference

IOsAxsExec
IOsAxs Interfaces