ADTF  3.18.2
Sample Stream Tracer RPC

Table of Contents

Introduction

The Sample Stream Tracer RPC is an interface to access statistics of streaming data. It replaces the Sample Stream Trace Provider and extends it with RPC access.

Concept

The Sample Stream Tracer RPC searches the Streaming Graphfor Output Pins, that have an Sample Stream connected to it. This also includes the Filter Graph embedded within the Streaming Graph and all further subgraphs. Due to the new Streaming Architecture, the Sample Stream Tracer RPC monitores the Data Pipe and the Trigger Pipe separately. The Sample Stream Tracer RPC can only be initialized in RL_FilterGraph or later. Otherwise it is not possible to get Sample Streams from within the Filter Graph.

Runtime Behaviour

The Sample Stream Tracer RPC is meant to be initialized during States of the Filter Graph RL_FilterGraph and will collect the Sample Streams to be monitored at that time. On a runlevel change to States of the Filter Graph RL_Running, all previously collected data is being reset. Decreasing the runlevel does not result in losing information unless the service is shut down. The registered subscriber of the Sample Stream Tracer RPC are not being notified that the service is no longer available if it is being shut down. As subscribing is only possible in Runlevel "filtergraph" or higher, those subscribers shall have unregistered themself by that point.

Use cases