RADIOINFO structure

C/C++ declaration

typedef int FAR *LPMODELIST;



typedef struct _RADIOINFO {

    DWORD       dwSize;

    DWORD       dwFeatures;

    WORD        wAPIVer;

    WORD        wHWVer;

    DWORD       dwMinFreq;

    DWORD       dwMaxFreq;

    int         iFreqRes;

    int         iNumModes;

    int         iMaxVolume;

    int         iMaxBFO;

    int         iMaxFMScanRate;

    int         iMaxAMScanRate;

    int         iHWInterface;

    int         iDeviceNum;

    int         iNumSources;

    int         iMaxIFShift;

    DWORD       dwWaveFormats;

    int         iDSPSources;

    LPMODELIST  lpSupportedModes;

    DWORD       dwMaxFreqkHz;

    char        szDeviceName[MAX_DEVNAME];

    int         iMaxIFGain;

    DWORD       dwSquelchFlags;

} RADIOINFO, *PRADIOINFO, FAR *LPRADIOINFO;



// For the above structure, make sure byte packing is set:

//   Microsoft Visual C++: #pragma pack(1)

//   Borland C++: #pragma option -a-

Delphi declaration

type

  TModeList = array [0..999] of Integer;

  PModeList = ^TModeList;



  TRadioInfo = packed record

    dwSize            : Longint;

    dwFeatures        : Longint;

    wAPIVer           : Word;

    wHWVer            : Word;

    dwMinFreq         : Longint;

    dwMaxFreq         : Longint;

    iFreqRes          : Integer;

    iNumModes         : Integer;

    iMaxVolume        : Integer;

    iMaxBFO           : Integer;

    iMaxFMScanRate    : Integer;

    iMaxAMScanRate    : Integer;

    iHWInterface      : Integer;

    iDeviceNum        : Integer;

    iNumSources       : Integer;

    iMaxIFShift       : Integer;

    dwWaveFormats     : Integer;

    iDSPSources       : Integer;

    lpSupportedModes  : PModeList;

    dwMaxFreqkHz      : Longint;

    szDeviceName      : array [0..MAX_DEVNAME-1] of Char;

    iMaxIFGain        : Integer;

    dwSquelchFlags    : Longint;

  end;

  PRadioInfo = ^TRadioInfo;

Members

dwSize

Specifies the size of the structure, in bytes. This must be filled before calling GetRadioDeviceInfo.

dwFeatures

A bit array specifying the hardware features available on the radio device:

wAPIVer

Specifies the version of the API, major version in the high byte, minor version in the low byte.

wHWVer

Specifies the hardware version of the radio device, major version in the high byte, minor version in the low byte. The following constants have been defined:

dwMinFreq

Specifies the lowest frequency the receiver can tune to in Hz. See SetFrequency.

dwMaxFreq

Specifies the highest frequency the receiver can tune to in Hz.

iFreqRes

Specifies the minimum tuning resolution of the receiver in Hz. Frequencies will always be rounded according to the resolution.

iNumModes

Specifies how many reception modes the receiver supports. The lpSupportedModes field (below) specifies these modes. Also see SetMode.

iMaxVolume

Specifies the maximum value that sets the volume to its highest level. See SetVolume.

iMaxBFO

Specifies the maximum frequency range (above and below zero) of the BFO offset. See SetBFOOffset.

iMaxFMScanRate

Specifies the maximum number of stations per second the receiver can scan in FM modes. See SetScanMode.

iMaxAMScanRate

Specifies the maximum number of stations per second the receiver can scan in AM and SSB modes.

iHWInterface

Specifies the interface the radio device is connected to. If the value is 0x180 or higher, it is an internal card. The following specifies the possible interface constants:

iDeviceNum

Specifies the logical device number of the radio device.

iNumSources

Specifies the number of audio sources that the audio output can be switched to. There is always at least one source (the radio itself). On the WR-3000i-DSP series, the second source is the DSP. See SetAudioSource.

iMaxIFShift

Specifies the maximum range for the IF shift above and below zero in Hz. See SetIFShift.

dwWaveFormats

Specifies what waveform-audio formats the DSP supports. The bit flags include:

iDSPSources

Specifies the number of sources the DSP can be connected to. There is always at least one source (the radio itself). On the WR-3000i-DSP series, the second source is the FMN discriminator (RDS_DATA) for data decoding. See SetDSPSource.

lpSupportedModes

Points to an integer array (LPMODELIST or PModeList) that contains a list of all the modes the devices can receive. All the modes specify noth the actual mode (RMD_xxx) and the bandwidth (RBW_xxx). See SetMode for more information. The list is read-only and cannot be modified.

dwMaxFreqkHz

The same as dwMaxFreq except the maximum frequency is specified in kHz.

szDeviceName

Zero terminated string containing device name. MAX_DEVNAME = 64.

iMaxIFGain

Maximum IF Gain value.

dwSquelchFlags

Combination of SPU_XXX flags for squelch suppor:

typedef struct _DSPHdr{

    char       *lpData;

    long int   dwBufferLength;

    long int   dwBytesTransferred;

    long int   dwUser;

    long int   dwFlags;

    long int   dwDateTransferred;

    long int   dwTimeTransferred;

}DSPHdr, *PDSPHdr;

type

  TDSPHdr = record

    lpData             : PChar;

    dwBufferLength     : Longint;

    dwBytesTransferred : Longint;

    dwUser             : Longint;

    dwFlags            : Longint;

    dwDateTransferred  : Longint;

    dwTimeTransferred  : Longint;

  end;

  PDSPHdr = ^TDSPHdr;

typedef struct _AduInfo{

    long int         iNumReceivers;

    long int         iNumAntennas;

    char             szAduName[MAX_DEVNAME];

    AduAntennaInfo   aiAntennaInfo[4];

}AduInfo, *PAduInfo;

type

  TAduInfo = record

    iNumReceivers  : Longint;

    iNumAntennas   : Longint;

    szAduName      : array [0..MAX_DEVNAME-1] of Char;  

    aiAntennaInfo  : array [0..3] of TAduAntennaInfo;

  end;

  PAduInfo = ^TAduInfo;

typedef struct _AduAntennaInfo{

    long int    dwLowFreqkHz;

    long int    dwHighFreqkHz;

    long int    dwLowFilterFreqkHz;

    long int    dwHighFilterFreqkHz;

    long int    dwAtten;

    long bool   fHasPreamp;  

}AduAntennaInfo, *PAduAntennaInfo;

type

  TAduAntennaInfo = record

    dwLowFreqkHz         : Longint;

    dwHighFreqkHz        : Longint;

    dwLowFilterFreqkHz   : Longint;

    dwHighFilterFreqkHz  : Longint;

    dwAtten              : Longint;

    fHasPreamp           : LongBool;

  end;