To initiate an IMGT session, an application must send an IMGT_CONFIG data structure to the IMGT manager. This data structure contains masks that indicate the message types the application expects to receive. IMGT_CONFIG is sent to the manager as a parameter in imgtStart. The data structure is defined as follows:
typedef struct IMGT_CONFIG
{
DWORD size; /* Size of this structure */
DWORD imgt_mask; /* Mask for maintenance messages */
DWORD trap_mask; /* Reserved for future use */
DWORD mon_mask; /* Mask to monitor specific messages */
WORD nfas_group; /* NFAS group number */
BYTE bpads[6]; /* Only required for configurations with
duplicate NAI values on a board */
} IMGT_CONFIG;
In this structure, imgt_mask, mon_mask, and trap_mask are bit masks that define which management events the application receives. The following table describes possible values for these masks:
|
Mask |
Value |
If set, the application receives... |
|---|---|---|
|
imgt_mask |
IMGT_SERVICE_MASK |
A notification whenever a SERVICE message is received on the trunk. |
|
imgt_mask |
IMGT_RESTART_MASK |
A notification whenever a RESTART message is received on the trunk. |
|
imgt_mask |
IMGT_D_CHANNEL_STATUS_MASK |
A notification whenever the status of a D channel changes. |
|
mon_mask |
IMGT_REPORT_MASK |
Some variant-specific messages. |