|
Recorder.TraceMask
The bit mask to be used with the indexth recorder trace. Only the bits specified by TraceMask will be recorded. For example, if TraceMask is set to 12 (1100 in binary), then only the 3rd and 4th bits of the associated trace will be recorded.
TraceMask is used only when TraceDataType is an integer data type.
Note: TraceMask will be modified when TraceSource is set and when SetTrace is called.
Version History
Introduced in MPX 2.0.
Type
UInt32 (read only)
Index
| |
| Index Type |
Description |
| UInt32 |
The index of the trace whose trace mask is to be accessed.
Valid values are 0 to (TraceCount-1) inclusive. |
|
Default
Long (read only)
Common Exceptions
| |
| Error |
Occurs when... |
| Argument |
When the specified index exceeds (TraceCount-1). |
|
Visual Basic
Syntax
Property TraceMask As UInt32(index As UInt32)
Sample Code
| |
Dim recorder As Mpx.Recorder = controller.Recorder(3)
' Acquire ownership of the Recorder
recorder.Acquire()
' Configure Recorder
recorder.ConfigurationBegin()
recorder.TraceCount = 2
recorder.SetTrace(0, Mpx.Map.SampleCounter)
recorder.TraceSource(1) = "MEIXmpBufferData.UserBuffer.Data[5]"
recorder.TraceDataType(1) = Mpx.DatatType.UInt32
recorder.TraceMask(1) = &H7FFFFF
recorder.Period = 0.01 ' 10 milliseconds
recorder.ConfigurationEnd()
' Add two buffers
recorder.BufferAdd(1.0) ' 1 second = 100 samples
recorder.BufferAdd(1.0)
' Start Recorder
recorder.Start()
|
Sample Application
C#
Syntax
uint[] TraceMask;
Sample Code
| |
Mpx.Recorder recorder = controller.Recorder[3];
// Acquire ownership of the Recorder
recorder.Acquire();
// Configure Recorder
recorder.ConfigurationBegin()
recorder.TraceCount = 2;
recorder.SetTrace(0, Mpx.Map.SampleCounter);
recorder.TraceSource[1] = "MEIXmpBufferData.UserBuffer.Data[5]";
recorder.TraceDataType[1] = Mpx.DatatType.UInt32;
recorder.TraceMask[1] = 0x7FFFFF;
recorder.Period = 0.01; // 10 milliseconds
recorder.ConfigurationEnd();
// Add two buffers
recorder.BufferAdd(1.0); // 1 second = 100 samples
recorder.BufferAdd(1.0);
// Start Recorder
recorder.Start(); |
See Also
SetTrace
TraceCount
TraceSource
TraceDataType
|
