XPS Unified Programmer’s Manual
7.2.1.14 DataCollectionRequest
Name
DataCollectionRequest – Gets data collection frame.
Input tests
- Refer to section 7.1: “Input Tests Common to all XPS Functions”.
Description
This function return a frame that contains the requested first blocks (max 500) of
current data collection.
The frame length can be from 0 (no block) to 500 blocks depending on the time
between the successive calls of DataCollectionRequest function. If the number of
available blocks is smaller than the requested blocks in the function call, the actual
number of blocks will be returned without error.
Example of a frame containing 4 data blocks :
0x1234ABCD 0x1234ABCD 0x1234ABCD 0x1234ABCD 0x1234ABCD 0x1234ABCD 0x1234ABCD
0x1234ABCD 0x1234ABCD 0x1234ABCD 0x1234ABCD 0x1234ABCD 0x1234ABCD 0x1234ABCD
0x1234ABCD;0x1234ABCD 0x1234ABCD 0x1234ABCD 0x1234ABCD 0x1234ABCD 0x1234ABCD
0x1234ABCD 0x1234ABCD 0x1234ABCD 0x1234ABCD 0x1234ABCD 0x1234ABCD 0x1234ABCD
0x1234ABCD 0x1234ABCD;0x1234ABCD 0x1234ABCD 0x1234ABCD 0x1234ABCD 0x1234ABCD
0x1234ABCD 0x1234ABCD 0x1234ABCD 0x1234ABCD 0x1234ABCD 0x1234ABCD 0x1234ABCD
0x1234ABCD 0x1234ABCD 0x1234ABCD;0x1234ABCD 0x1234ABCD 0x1234ABCD 0x1234ABCD
0x1234ABCD 0x1234ABCD 0x1234ABCD 0x1234ABCD 0x1234ABCD 0x1234ABCD 0x1234ABCD
0x1234ABCD 0x1234ABCD 0x1234ABCD 0x1234ABCD
Prototype
int DataCollectionRequest(
int SocketID,
int NbRequestBlocks,
int *NbReturnBlocks,
char *Frame
)
Input parameters
SocketID string Socket identifier used in each function.
NbRequestBlocks int Number of data blocks to get.
Output parameters
NbReturnBlocks int * Number of actually returned blocks.
Frame char * Blocks of collected data.
Return (In addition to the results of “Input Tests Common to all XPS
Functions”)
• 0: No error.
EDH0373En1023 — 01/18 56
To Next Page
Loading...
