Preset Zone Info [pzi]
This request returns a
Cue Stack Info
data structure for the specified preset zone. Use this response to
determine which presets are active in a given zone.
URL:
/get.cgi?req=pzi&name=<zoneName>
Parameters:
•
name=<zoneName>
◦ The name of the desired zone.
Response:
The following variable-length structure is returned by this request:
#define STACK_NAME_BUF_SIZE 16
#define CSI_TYPE_CUES 0
#define CSI_TYPE_PRESETS 1
typedef struct CueStackInfo {
uint16_t signature; // Signature = 'CS'
int16_t version; // Version = 0x0001 (or negative
error code)
char stackName[STACK_NAME_BUF_SIZE]; // Name of stack
uint8_t type; // 0 = Cues, 1 = Presets
uint8_t playback; // The playback number (for
presets only)
uint16_t count; // Number of CueID/Status pairs
uint32_t data[64]; // Array of CueID/Status pairs
(32 pairs max)
} CueStackInfo;
The CueID/Status pairs are included for any preset in the zone that is active. The CueID denotes the preset
number and the Status value indicates the preset’s active state. The following table shows preset states:
Please note that the actual number of bytes returned by this request only includes the actual number of
pairs of
uint32_t
elements in the
data[]
array.
*
Interactive Technologies, Inc.
CueServer 2 User's Manual - 18.5.18
Page 317 of 429
