PsAddBreakPointFilter

Adds a filter to a breakpoint.

Syntax

PULSE_STATUS PsAddBreakPointFilter(
 [in] PPS_ENGINE pEngine,
 [in] uint16_t BreakPointId,
 [in] PPS_BREAK_POINT_FILTER_PARAMS pBreakPointFilterParams,
 [out, optional] uint16_t *pBreakPointFilterId
);

Parameters

PPS_ENGINE pEngine

An opaque handle to an engine created by the EngCreateEngine function.

uint16_t BreakPointId

The ID of the target breakpoint. The breakpoint must have been previously set using the PsSetBreakPoint function.

PPS_BREAK_POINT_FILTER_PARAMS pBreakPointFilterParams

The parameters for the filter to be added. Refer to the PS_BREAK_POINT_FILTER_PARAMS structure.

uint16_t *pBreakPointFilterId

Receives the breakpoint filter ID.

Return value

If the function succeeds, the return value is PULSE_STATUS_SUCCESS.

If it fails, it returns one of the PULSE_STATUS values. Possible return codes include, but are not limited to, the following:

PULSE_STATUS_INSUFFICIENT_RESOURCES
0xC0000002		 One of the memory allocations failed during initialization.
PULSE_STATUS_READ_FAILED
0xC0000003		 Transport communication failed during a read operation.
PULSE_STATUS_WRITE_FAILED
0xC0000004		 Transport communication failed during a write operation.
PULSE_STATUS_TIMEOUT
0xC0000007		 Might happen if
  • Transport I/O timed out.
  • No response was received from the debuggee within the request timeout period.
PULSE_STATUS_INVALID_PARAMETER
0xC0000010		 Might happen if
  • The pEngine parameter is NULL.
  • The pBreakPointFilterParams parameter is NULL.
PULSE_STATUS_INVALID_PACKET
0xC0000031		 An invalid or unexpected packet was received in response.
PULSE_STATUS_TARGET_NOT_STOPPED
0xC0000045		 An attempt was made to add the breakpoint filter while the target was running.
PULSE_STATUS_BREAKPOINT_NOT_FOUND
0xC0000101		 The breakpoint was not found.
PULSE_STATUS_FILTER_TABLE_FULL
0xC0000200		 The breakpoint filter count limit has been reached.
PULSE_STATUS_DEVICE_CONNECTION_LOST
0xC0000308		 The connection to the transport was lost. Try restarting the engine or the transport.

Remarks

A breakpoint filter can be added only while the target is stopped.

The current maximum breakpoint filter count is 1024.