3 Appendix A – Programming the PC-FM6-32
12
Comments
This function can fail with ERROR_DEVICE_NOT_READY if the RDS signal
is not being received or the Program Service Name is in the process of
being
changed.
The RDSProgramInformation structure is defined as follows:
typedef struct
{
unsigned
ProgramIdentificationCode;
unsigned
ProgramTypeCode;
unsigned
Music;
unsigned
Traffic;
unsigned
Decoder;
char
ProgramServiceName[9];
}
RDSProgramInformation;
ProgramIdentificationCode
: See RDS specification NRSC-4-A Annex D.
ProgramTypeCode
: See RDS specification NRSC-4-A Annex F.
Music
: 0 = Speech, 1 = Music
Traffic
: 0 = This program does not carry traffic announcements
1 = This program contains EON information about another program
that carries traffic announcements
2 = This program carries traffic announcements but none are being
broadcast at present
3 = A traffic announcement is being broadcast on this program at
present
Decoder
: Bit 0 set = Stereo, cleared = Monaural
Bit 1 set = Artificial head, cleared = Not artificial head
Bit 2 set = Compressed, cleared = Uncompressed
Bit 3 set = PTY code dynamically switched, cleared = PTY code
static
ProgramServiceName
: Null-terminated string identifying the program
BOOL __stdcall RadcapRDSGetRadiotext
(
enum RadcapTunerType Mode,
int
TunerID,
char
*Buffer,
size_t
BufferSize);
Parameters
Mode
Specifies AM or FM tuner.
TunerID
Index of the station to be read, beginning at zero for the first
station.
Buffer
Pointer to an array of at least 65 chars into which the function
writes the Radiotext as a null-terminated string.
BufferSize
Size in bytes of Buffer.
Return value
The return value TRUE if the function succeeds, otherwise it is FALSE.
To obtain extended error information, call GetLastError ().
Comments
This function can return an empty string if updated text is only partially
received or if no Radiotext is being broadcast.
BOOL __stdcall RadcapRDSGetLocalDateTime
(
enum RadcapTunerType Mode,
int
TunerID,
SYSTEMTIME *pLocalTime );
Parameters
Mode
Specifies AM or FM tuner.