Recorded Announcement Query 0x0057

SwitchKit Name

RecAnnQuery

Type

EXS API and SwitchKit API message

Description

This message allows the host to query information about the announcements stored on a VRAS SIMM. The information is reported to the host via the Recorded Announcement Report message:

• If announcements are stored on the SIMM, the response to this message indicates the number of announcements stored on the specified SIMM.

• If no announcements are stored on the VRAS SIMM, the Excel platform does not send a report.

In the Recorded Announcement Report message, the host will receive the ID, size, checksum, format, and encoding format for each announcement stored on the specified SIMM.

Sent by

Host

SwitchKit Code

C Structure

typedef struct {

UBYTE Slot;

UBYTE SIMM;

} XL_RecAnnQuery;

C Structure Response

typedef struct {

unsigned short Status;

UBYTE Slot;

UBYTE SIMM;

unsigned short AnnounceCount;

} XL_RecAnnQueryAck;

C++ Class

class XLC_RecAnnQuery : public XLC_OutboundMessage {

public:

UBYTE getSlot() const;

void setSlot(UBYTE x);

UBYTE getSIMM() const;

void setSIMM(UBYTE x);

};

C++ Class Response

class XLC_RecAnnQueryAck : public XLC_AcknowledgeMessage {

public:

unsigned short getStatus() const;

void setStatus(unsigned short x);

UBYTE getSlot() const;

void setSlot(UBYTE x);

UBYTE getSIMM() const;

void setSIMM(UBYTE x);

unsigned short getAnnounceCount() const;

void setAnnounceCount(unsigned short x);

};

EXS API Hex Format