H324_LCD

Conveys information about the local and remote channels between the host application and the remote terminal. The H324_LCD structure is in a set of structures that also includes the MEDIA_UNION structure, which contains media options for specific media types.

H324_LCD is used with inbound H324EVN_LCD events.

The H.324M Middleware uses this structure set to describe the following:

The final bi-directional channel established by the host application and the remote terminal.
An incoming unidirectional OLC request accepted by H.324M Middleware.
An outgoing unidirectional OLC request accepted by the remote terminal.

Definition

typedef struct tag_H324_LCD
{
   // Receive Info
   H324_BOOL     bReceive;
   int           rxChannel;
   DWORD         rxChoice;
    MEDIA_UNION rxU;

   // Transmit Info
   H324_BOOL     bTransmit;
   int           txChannel;
   DWORD         txChoice;
    MEDIA_UNION txU;
}H324_LCD;

Fields in the H324_LCD structure

Field name	Description
bReceive	Indicates whether the rxU field contains media options for the Rx channel in a full-duplex configuration. Valid values are: TRUE - rxU field contains media options for the Rx channel. FALSE - rxU field is not in use.
rxChannel	The channel number of the receiving channel.
rxChoice	Describes how to interpret rxU union. Valid values are: H324_MPEG4_VIDEO (0) H324_H263_VIDEO (1) H324_H261_VIDEO (2) (Not supported) H324_G711_AUDIO (3) (Not supported) H324_G723_AUDIO (4) H324_AMR_AUDIO (5) H324_H264_VIDEO (6)
rxU	MEDIA_UNION structure, which contains different media options, according to the value of the txChoice field.
bTransmit	Whether the txU field contains media options for the Tx channel. Valid values are: TRUE: txU field contains media options for the Tx channel. FALSE: txU field is not in use.
txChannel	Channel number of the channel that transmits data.
txChoice	Describes how to interpret txU union. Valid values are: H324_MPEG4_VIDEO (0) H324_H263_VIDEO (1) H324_H261_VIDEO (2) (Not supported) H324_G711_AUDIO (3) (Not supported) H324_G723_AUDIO (4) H324_AMR_AUDIO (5) H324_H264_VIDEO (6)
txU	MEDIA_UNION structure, which contains different media options, according to the value of the txChoice field.

Fields in the MEDIA_UNION structure

Type	Field name	Description
MMP4VIDEOOPTIONS	mpeg4	MMP4VIDEOOPTIONS structure that contains MPEG-4 video options.
MH263OPTIONS	h263	MH263OPTIONS structure that contains H.263 video options.
MH261OPTIONS	h261	H.261 video options. (Not supported)
MG711OPTIONS	g711	MG711OPTIONS structure that contains G.711 audio options. (Not supported)
MG7231OPTIONS	g723	MG7231OPTIONS structure that contains G.723.1 audio options.
MGSMAMROPTIONS	gsmamr	MGSMAMROPTIONS structure that contains AMR audio options.
H264VIDEOOPTIONS	h264	H264VIDEOOPTIONS structure that contains H.264 video options.
MAMRWBOPTIONS	amrwb	MAMRWBOPTIONS structure that contains AMR-WB video options. (Not supported)
USERINPUTOPTIONS	uinp	The USERINPUTOPTIONS structure that tells the remote side what types of user input messages the 3G-324M Interface can decode. The 3G-324M Interface currently supports all user interface options except for option 11 (generic user input).

The USERINTPUTOPTIONS structure definition is:

#define MAXSUBIDS 128
struct _h245ObjIdentifier
{
unsigned int     numOfids;
unsigned int     subid[MAXSUBIDS];
};struct _H245_H221NonStandard
{
unsigned char countryCode;        //t35
unsigned char extension;          //t35
unsigned short manufacturerCode;   //0...65535
};
struct _H245_NonStandardIdentifier   //of type h221 non standard, refer to annex B of rec.
{
#define H245_OBJECT         1
#define H245_NON_STANDARD   2
char choice;
union
{
t_H245ObjIdentifier* object;
t_H245_H221NonStandard* h221NonStandard;
}u;
};typedef struct _USERINPUTOPTIONS
{
  #define USER_INPUT_NON_STANDARD 0;
  #define USER_INPUT_BASIC_STRING 1;
  #define USER_INPUT_IA5_STRING 2;
  #define USER_INPUT_GENERAL_STRING 3;
  #define USER_INPUT_DTMF 4;
  #define USER_INPUT_HOOKFLASH 5;
  #define USER_INPUT_EXTENDED_ALPHA_NUMERIC 6;
  #define USER_INPUT_ENCRYPTED_BASIC_STRING 7;
  #define USER_INPUT_ENCRYPTED_IA5_STRING 8;
  #define USER_INPUT_ENCRYPTED_GENERAL_STRING 9;
  #define USER_INPUT_SECURE_DTMF 10;
  #define USER_INPUT_GENERIC_USER_INPUT_CAPABILITY 11;
  int choice;
unsigned char nonStandardCount;
t_H245_NonStandardParameter nonStandardParam[16];
} USERINPUTOPTIONS;

For detailed information about the codec-related structures in MEDIA_UNION, see the associated ITU-T specifications.