API Scope.AddPort: Difference between revisions
XML import API changes |
XML import |
||
| (3 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
<sidebar>API | <sidebar>API Contents</sidebar> | ||
Adds an input to the stream from a port | Adds an input to the stream from a port | ||
| Line 10: | Line 10: | ||
==Parameters== | ==Parameters== | ||
[[Variable | [[Variable Types|HANDLE]] ''StreamH'' | ||
:A handle to a previously created datascope stream | :A handle to a previously created datascope stream | ||
[[Variable | [[Variable Types|ULONG]] ''PortIndex'' | ||
:A zero-based port index, or a textual port name | :A zero-based port index, or a textual port name | ||
[[Variable | [[Variable Types|ULONG]] ''BitMask'' | ||
:The bits of the port to isolate and use | :The bits of the port to isolate and use | ||
:''The default value for this parameter is: '''''-1''' | :''The default value for this parameter is: '''''-1''' | ||
[[Variable | [[Variable Types|BOOL]] ''PackMask'' | ||
:True to pack all the bits together, false to leave gaps | :True to pack all the bits together, false to leave gaps | ||
:''The default value for this parameter is: '''''1''' | :''The default value for this parameter is: '''''1''' | ||
[[Variable | [[Variable Types|BOOL]] ''Merge'' | ||
:True to bitwise-or the bits with the current data, false to append to the end | :True to bitwise-or the bits with the current data, false to append to the end | ||
:''The default value for this parameter is: '''''0''' | :''The default value for this parameter is: '''''0''' | ||
| Line 30: | Line 30: | ||
==Return value== | ==Return value== | ||
[[Variable | [[Variable Types|BOOL]] | ||
Returns true if the operation is a success, else false | Returns true if the operation is a success, else false | ||
| Line 44: | Line 44: | ||
* Add to a calculation icon: <pre class="brush:[cpp]">result = ::Scope.AddPort(streamh, portindex, bitmask, true, false)</pre> | * Add to a calculation icon: <pre class="brush:[cpp]">result = ::Scope.AddPort(streamh, portindex, bitmask, true, false)</pre> | ||
''<span style="color:red;">No additional | ''<span style="color:red;">No additional examples</span>'' | ||
Latest revision as of 15:57, 16 January 2014
<sidebar>API Contents</sidebar> Adds an input to the stream from a port
Parameters
HANDLE StreamH
- A handle to a previously created datascope stream
ULONG PortIndex
- A zero-based port index, or a textual port name
ULONG BitMask
- The bits of the port to isolate and use
- The default value for this parameter is: -1
BOOL PackMask
- True to pack all the bits together, false to leave gaps
- The default value for this parameter is: 1
BOOL Merge
- True to bitwise-or the bits with the current data, false to append to the end
- The default value for this parameter is: 0
Return value
Returns true if the operation is a success, else false
Detailed description
No additional information
Examples
Calling in a calculation
- Declare a variable 'result' of type BOOL
- Add to a calculation icon:
result = ::Scope.AddPort(streamh, portindex, bitmask, true, false)
No additional examples