wanpipe_api_hdr.h

Go to the documentation of this file.

/******************************************************************************/
#ifndef __WANPIPE_API_HDR__
#define __WANPIPE_API_HDR__


#pragma pack(1)

#define WAN_MAX_EVENT_SZ 64
#define WAN_MAX_EVENT_SZ_UNION WAN_MAX_EVENT_SZ-(sizeof(u_int8_t)*4)-(sizeof(u_int32_t)*2)

typedef struct wp_api_event
{
    u_int8_t    event_type;         
    u_int8_t    mode;               
    u_int8_t    channel;            
    u_int8_t    span;               
    u_int32_t   time_stamp_sec;     
    u_int32_t   time_stamp_usec;    
    union {
        struct {
            u_int32_t   alarm;      
        } te1_alarm;
        struct {
            u_int8_t    rbs_bits;   
        } te1_rbs;
        struct {
            u_int8_t    state;      
            u_int8_t    sig;        
        } rm_hook;
        struct {
            u_int8_t    state;      
        } rm_ring;
        struct {
            u_int16_t   type;       
        } rm_tone;
        struct {
            u_int8_t    digit;      
            u_int8_t    port;       
            u_int8_t    type;       
        } dtmf;
        struct {
            u_int16_t   polarity;   
            u_int16_t   ohttimer;   
            u_int16_t   polarity_reverse;   
        } rm_common;
        struct {
            int32_t gain;
        }rm_gain;
        struct{
            u_int16_t   status;     
        } linkstatus;
        struct {
            u_int32_t   status;     
        } serial;
        unsigned char reserved[WAN_MAX_EVENT_SZ_UNION]; 
    };

/***************************************************/
#define wp_api_event_type               event_type
#define wp_api_event_mode               mode
#define wp_api_event_channel            channel
#define wp_api_event_span               span
#define wp_api_event_alarm              te1_alarm.alarm
#define wp_api_event_rbs_bits           te1_rbs.rbs_bits
#define wp_api_event_hook_state         rm_hook.state
#define wp_api_event_hook_sig           rm_hook.sig
#define wp_api_event_ring_state         rm_ring.state
#define wp_api_event_tone_type          rm_tone.type
#define wp_api_event_dtmf_digit         dtmf.digit
#define wp_api_event_dtmf_type          dtmf.type
#define wp_api_event_dtmf_port          dtmf.port
#define wp_api_event_ohttimer           rm_common.ohttimer
#define wp_api_event_polarity           rm_common.polarity
#define wp_api_event_polarity_reverse   rm_common.polarity_reverse
#define wp_api_event_link_status        linkstatus.status
#define wp_api_event_serial_status      serial.status
#define wp_api_event_time_stamp_sec     time_stamp_sec
#define wp_api_event_time_stamp_usec    time_stamp_usec
#define wp_api_event_gain_value         rm_gain.gain
} wp_api_event_t;


/***************************************************/
#define WAN_MAX_HDR_SZ 64
#define WAN_MAX_HDR_SZ_UNION WAN_MAX_HDR_SZ-sizeof(u_int8_t)-sizeof(u_int16_t)-(sizeof(u_int32_t)*2)

typedef struct wp_api_hdr
{
    u_int8_t    operation_status;       
    u_int16_t   data_length;            
    u_int32_t   time_stamp_sec;         
    u_int32_t   time_stamp_usec;        
    union {
        /***********************************************/
        struct {
            u_int16_t   crc;                                    
            u_int8_t    max_rx_queue_length;                    
            u_int8_t    current_number_of_frames_in_rx_queue;   
            u_int32_t   errors;                                 
        }rx_h;

        struct {
            u_int8_t    max_tx_queue_length;                    
            u_int8_t    current_number_of_frames_in_tx_queue;   
            u_int32_t   tx_idle_packets;                        
            u_int32_t   errors;                                 
        }tx_h;

        /***********************************************/
        struct {
            u_int8_t    status;
        }serial;
        struct {
            u_int8_t    exception;
            u_int8_t    pf;
        }lapb;
        struct {
            u_int8_t    state;
            u_int8_t    address;
            u_int16_t   exception;
        }xdlc;
        struct {
            u_int8_t    channel;
            u_int8_t    direction;
        }bitstrm;
        struct {
            u_int8_t    channel;
            u_int8_t    status;
        }aft_legacy_rbs;
        struct {
            u_int8_t    repeat;
            u_int8_t    len;
            u_int8_t    data[8];
        }rpt;
        struct {
            u_int8_t    type;
            u_int8_t    force_tx;
            u_int8_t    data[8];
        }ss7_hw;
        u_int8_t reserved[WAN_MAX_HDR_SZ_UNION];
    };


/***************************************************/
#define wp_api_hdr_operation_status             operation_status
#define wp_api_hdr_data_length                  data_length
#define wp_api_hdr_time_stamp_sec               time_stamp_sec
#define wp_api_hdr_time_stamp_use               time_stamp_usec

#define wp_api_legacy_rbs_channel               aft_legacy_rbs.channel
#define wp_api_legacy_rbs_status                aft_legacy_rbs.status

#define wp_api_rx_hdr_crc                       rx_h.crc
#define wp_api_rx_hdr_error_map                 rx_h.crc
#define wp_api_rx_hdr_max_queue_length          rx_h.max_rx_queue_length
#define wp_api_rx_hdr_number_of_frames_in_queue rx_h.current_number_of_frames_in_rx_queue
#define wp_api_rx_hdr_time_stamp_sec            time_stamp_sec
#define wp_api_rx_hdr_time_stamp_use            time_stamp_usec
#define wp_api_rx_hdr_errors                    rx_h.errors

#define wp_api_tx_hdr_max_queue_length          tx_h.max_tx_queue_length
#define wp_api_tx_hdr_number_of_frames_in_queue tx_h.current_number_of_frames_in_tx_queue
#define wp_api_tx_hdr_tx_idle_packets           tx_h.tx_idle_packets
#define wp_api_tx_hdr_time_stamp_sec            time_stamp_sec
#define wp_api_tx_hdr_time_stamp_use            time_stamp_usec
#define wp_api_tx_hdr_errors                    tx_h.errors

/***********************************************/
#if !defined(__WINDOWS__)
#define wp_api_rx_hdr_error_flag                operation_status
#define wp_api_rx_hdr_station                   operation_status
#define wp_api_rx_hdr_time_stamp                data_length
#endif

#define wp_api_tx_hdr_hdlc_rpt_len              rpt.len
#define wp_api_tx_hdr_hdlc_rpt_data             rpt.data
#define wp_api_tx_hdr_hdlc_rpt_repeat           rpt.repeat

#define wp_api_tx_hdr_aft_ss7_type              ss7_hw.type
#define wp_api_tx_hdr_aft_ss7_force_tx          ss7_hw.force_tx
#define wp_api_tx_hdr_aft_ss7_data              ss7_hw.data

/* XDLC Old backdward comptabile */
#define wp_api_rx_hdr_xdlc_state                xdlc.state
#define wp_api_rx_hdr_xdlc_address              xdlc.address
#define wp_api_rx_hdr_xdlc_exception            xdlc.exception

#define wan_hdr_xdlc_state                      xdlc.state
#define wan_hdr_xdlc_address                    xdlc.address
#define wan_hdr_xdlc_exception                  xdlc.exception

/* CHDLC Old backdward comptabile */
#define wp_api_rx_hdr_chdlc_error_flag          wp_api_rx_hdr_error_flag
#define wp_api_rx_hdr_chdlc_time_stamp          wp_api_rx_hdr_time_stamp
#define wp_api_rx_hdr_chdlc_time_sec            time_stamp_sec
#define wp_api_rx_hdr_chdlc_time_usec           time_stamp_usec

#define wan_hdr_chdlc_error_flag                wp_api_rx_hdr_chdlc_error_flag
#define wan_hdr_chdlc_time_stamp                wp_api_rx_hdr_chdlc_time_stamp
#define wan_hdr_chdlc_time_sec                  wp_api_rx_hdr_chdlc_time_sec
#define wan_hdr_chdlc_time_usec                 wp_api_rx_hdr_chdlc_time_usec

/* BITSTRM Old backdward comptabile */
#define wp_api_rx_hdr_bitstrm_error_flag        wp_api_rx_hdr_error_flag
#define wp_api_rx_hdr_bitstrm_time_stamp        wp_api_rx_hdr_time_stamp
#define wp_api_rx_hdr_bitstrm_time_sec          time_stamp_sec
#define wp_api_rx_hdr_bitstrm_time_usec         time_stamp_usec
#define wp_api_rx_hdr_bitstrm_channel           bitstrm.channel
#define wp_api_rx_hdr_bitstrm_direction         bitstrm.direction

#define wan_hdr_bitstrm_error_flag              wp_api_rx_hdr_bitstrm_error_flag
#define wan_hdr_bitstrm_time_stamp              wp_api_rx_hdr_bitstrm_data_length
#define wan_hdr_bitstrm_time_sec                wp_api_rx_hdr_bitstrm_time_sec
#define wan_hdr_bitstrm_time_usec               wp_api_rx_hdr_bitstrm_time_usec
#define wan_hdr_bitstrm_channel                 wp_api_rx_hdr_bitstrm_channel
#define wan_hdr_bitstrm_direction               wp_api_rx_hdr_bitstrm_direction

/* HDLC Old backdward comptabile */
#define wp_api_rx_hdr_hdlc_error_flag           wp_api_rx_hdr_error_flag
#define wp_api_rx_hdr_hdlc_time_stamp           wp_api_rx_hdr_time_stamp
#define wp_api_rx_hdr_hdlc_time_sec             time_stamp_sec
#define wp_api_rx_hdr_hdlc_time_usec            time_stamp_usec

#define wan_hdr_hdlc_error_flag                 wp_api_rx_hdr_error_flag
#define wan_hdr_hdlc_time_stamp                 wp_api_rx_hdr_time_stamp

/* LAPBS Old backdward comptabile */
#define wp_api_rx_hdr_lapb_pf                   lapb.pf
#define wp_api_rx_hdr_lapb_exception            lapb.exception
#define wp_api_rx_hdr_lapb_time_sec             time_stamp_sec
#define wp_api_rx_hdr_lapb_time_usec            time_stamp_usec

#define wan_hdr_lapb_pf                         wp_api_rx_hdr_lapb_pf
#define wan_hdr_lapb_exception                  wp_api_rx_hdr_lapb_exception

/* FR Old backdward comptabile */
#define wp_api_rx_hdr_fr_attr                   wp_api_rx_hdr_error_flag
#define wp_api_rx_hdr_fr_time_stamp             wp_api_rx_hdr_time_stamp
#define wp_api_rx_hdr_fr_time_sec               time_stamp_sec
#define wp_api_rx_hdr_fr_time_usec              time_stamp_usec

#define wan_hdr_fr_attr                         wp_api_rx_hdr_fr_attr
#define wan_hdr_fr_time_stamp                   wp_api_rx_hdr_fr_time_stamp
#define wan_hdr_fr_time_sec                     wp_api_rx_hdr_fr_time_sec
#define wan_hdr_fr_time_usec                    wp_api_rx_hdr_fr_time_usec

/* SS7 Legacy Old backdward comptabile */
#define wp_api_rx_hdr_ss7_legacy_sio            wp_api_rx_hdr_error_flag
#define wp_api_rx_hdr_ss7_legacy_time_stamp     wp_api_rx_hdr_time_stamp

#define wp_api_rx_hdr_event_serial_status       serial.status

} wp_api_hdr_t;


/***********************************************/
#define MAX_NO_DATA_BYTES_IN_FRAME  8188


typedef struct wp_api_element{

    wp_api_hdr_t    hdr;    
    unsigned char   data[MAX_NO_DATA_BYTES_IN_FRAME];   
/***************************************************/
#define wp_api_el_operation_status              hdr.wp_api_hdr_operation_status
#define wp_api_el_data_length                   hdr.wp_api_hdr_data_length
#define wp_api_el_time_stamp_sec                hdr.wp_api_hdr_time_stamp_sec
#define wp_api_el_time_stamp_use                hdr.wp_api_hdr_time_stamp_use

#define wp_api_rx_el_crc                        hdr.wp_api_rx_hdr_crc
#define wp_api_rx_el_max_queue_length           hdr.wp_api_rx_hdr_max_queue_length
#define wp_api_rx_el_number_of_frames_in_queue  hdr.wp_api_rx_hdr_number_of_frames_in_queue

#define wp_api_tx_el_max_queue_length           hdr.wp_api_tx_hdr_max_queue_length
#define wp_api_tx_el_number_of_frames_in_queue  hdr.wp_api_tx_hdr_number_of_frames_in_queue

} wp_api_element_t;


#pragma pack()


/**************************************************************
 Sangoma Memory descriptors - passed to/from kernel/user space
***************************************************************/

#pragma pack(1)         

typedef struct wan_iovec
{
    u_int32_t iov_len;
    
    void * WP_POINTER_64 iov_base;
#ifndef __x86_64__
    u_int32_t reserved;
#endif
}wan_iovec_t;

#define WAN_IOVEC_LIST_LEN  5
typedef struct wan_iovec_list
{
    wan_iovec_t iovec_list[WAN_IOVEC_LIST_LEN];
}wan_iovec_list_t;

typedef struct wan_msghdr {
    u_int32_t  msg_iovlen; 
    wan_iovec_t * WP_POINTER_64 msg_iov;    
#ifndef __x86_64__
    u_int32_t reserved;
#endif
}wan_msghdr_t;

#pragma pack()

/****************************************************************/

typedef struct _API_POLL_STRUCT
{
    unsigned char   operation_status;   
    u_int32_t       user_flags_bitmap;  
    u_int32_t       poll_events_bitmap; 
}API_POLL_STRUCT;


typedef enum SANG_STATUS
{

    SANG_STATUS_SUCCESS=0,                  
    /*************************************/
    SANG_STATUS_RX_DATA_TIMEOUT,            
    SANG_STATUS_RX_DATA_AVAILABLE,          
    SANG_STATUS_NO_DATA_AVAILABLE,          
    /*************************************/
    SANG_STATUS_TX_TIMEOUT,                 
    SANG_STATUS_TX_DATA_TOO_LONG,           
    SANG_STATUS_TX_DATA_TOO_SHORT,          
    SANG_STATUS_TX_HDR_TOO_SHORT,           
    /*************************************/
    SANG_STATUS_LINE_DISCONNECTED,          
    SANG_STATUS_PROTOCOL_DISCONNECTED,      
    SANG_STATUS_LINE_CONNECTED,             
    SANG_STATUS_PROTOCOL_CONNECTED,         
    /*************************************/
    SANG_STATUS_COMMAND_ALREADY_RUNNING,    
    SANG_STATUS_BUFFER_TOO_SMALL,           
    SANG_STATUS_FAILED_TO_LOCK_USER_MEMORY, 
    SANG_STATUS_FAILED_ALLOCATE_MEMORY,     
    SANG_STATUS_INVALID_DEVICE_REQUEST,     
    SANG_STATUS_INVALID_PARAMETER,          
    SANG_STATUS_GENERAL_ERROR,              
    SANG_STATUS_DEVICE_BUSY,                
    SANG_STATUS_INVALID_DEVICE,             
    SANG_STATUS_IO_ERROR,                   
    SANG_STATUS_UNSUPPORTED_FUNCTION,       
    SANG_STATUS_UNSUPPORTED_PROTOCOL,       
    SANG_STATUS_DEVICE_ALREADY_EXIST,       
    SANG_STATUS_DEV_INIT_INCOMPLETE,        
    SANG_STATUS_TRACE_QUEUE_EMPTY,          
    SANG_STATUS_OPTION_NOT_SUPPORTED,       
    /*************************************/
    SANG_STATUS_API_EVENT_AVAILABLE,        
    /*************************************/
    SANG_STATUS_CAN_NOT_STOP_DEVICE_WHEN_ALREADY_STOPPED,       
    SANG_STATUS_CAN_NOT_RUN_TWO_PORT_CMDS_AT_THE_SAME_TIME,     
    SANG_STATUS_ASSOCIATED_IRP_SYSTEM_BUFFER_NULL_ERROR,        
    SANG_STATUS_STRUCTURE_SIZE_MISMATCH_ERROR,      
    /*************************************/
    SANG_STATUS_REGISTRY_ERROR=180,             
    SANG_STATUS_IO_PENDING,                     
    SANG_STATUS_APIPOLL_TIMEOUT,                
    SANG_STATUS_NO_FREE_BUFFERS,
    SANG_STATUS_SHARED_EVENT_INIT_ERROR,        
    /****************************************/
    SANG_STATUS_DATA_QUEUE_EMPTY=190,           
    SANG_STATUS_DATA_QUEUE_FULL,                
    SANG_STATUS_INVALID_IRQL                    
}SANG_STATUS_T;

#define SDLA_DECODE_SANG_STATUS(status) \
(abs((int)status) == SANG_STATUS_SUCCESS) ? "SANG_STATUS_SUCCESS" :\
(abs((int)status) == SANG_STATUS_COMMAND_ALREADY_RUNNING) ? "SANG_STATUS_COMMAND_ALREADY_RUNNING":\
(abs((int)status) == SANG_STATUS_BUFFER_TOO_SMALL) ? "SANG_STATUS_BUFFER_TOO_SMALL":\
(abs((int)status) == SANG_STATUS_FAILED_TO_LOCK_USER_MEMORY) ? "SANG_STATUS_FAILED_TO_LOCK_USER_MEMORY":\
(abs((int)status) == SANG_STATUS_FAILED_ALLOCATE_MEMORY) ? "SANG_STATUS_FAILED_ALLOCATE_MEMORY":\
(abs((int)status) == SANG_STATUS_INVALID_DEVICE_REQUEST) ? "SANG_STATUS_INVALID_DEVICE_REQUEST":\
(abs((int)status) == SANG_STATUS_INVALID_PARAMETER) ? "SANG_STATUS_INVALID_PARAMETER":\
(abs((int)status) == SANG_STATUS_DATA_QUEUE_EMPTY) ? "SANG_STATUS_DATA_QUEUE_EMPTY":\
(abs((int)status) == SANG_STATUS_DATA_QUEUE_FULL) ? "SANG_STATUS_DATA_QUEUE_FULL":\
(abs((int)status) == SANG_STATUS_RX_DATA_TIMEOUT) ? "SANG_STATUS_RX_DATA_TIMEOUT":\
(abs((int)status) == SANG_STATUS_RX_DATA_AVAILABLE) ? "SANG_STATUS_RX_DATA_AVAILABLE":\
(abs((int)status) == SANG_STATUS_TX_TIMEOUT) ? "SANG_STATUS_TX_TIMEOUT":\
(abs((int)status) == SANG_STATUS_TX_DATA_TOO_LONG) ? "SANG_STATUS_TX_DATA_TOO_LONG":\
(abs((int)status) == SANG_STATUS_TX_DATA_TOO_SHORT) ? "SANG_STATUS_TX_DATA_TOO_SHORT":\
(abs((int)status) == SANG_STATUS_LINE_DISCONNECTED) ? "SANG_STATUS_LINE_DISCONNECTED":\
(abs((int)status) == SANG_STATUS_LINE_CONNECTED) ? "SANG_STATUS_LINE_CONNECTED":\
(abs((int)status) == SANG_STATUS_PROTOCOL_DISCONNECTED) ? "SANG_STATUS_PROTOCOL_DISCONNECTED":\
(abs((int)status) == SANG_STATUS_PROTOCOL_CONNECTED) ? "SANG_STATUS_PROTOCOL_CONNECTED":\
(abs((int)status) == SANG_STATUS_GENERAL_ERROR) ? "SANG_STATUS_GENERAL_ERROR":\
(abs((int)status) == SANG_STATUS_DEVICE_BUSY) ? "SANG_STATUS_DEVICE_BUSY":\
(abs((int)status) == SANG_STATUS_INVALID_DEVICE) ? "SANG_STATUS_INVALID_DEVICE":\
(abs((int)status) == SANG_STATUS_IO_ERROR) ? "SANG_STATUS_IO_ERROR":\
(abs((int)status) == SANG_STATUS_UNSUPPORTED_FUNCTION) ? "SANG_STATUS_UNSUPPORTED_FUNCTION":\
(abs((int)status) == SANG_STATUS_UNSUPPORTED_PROTOCOL) ? "SANG_STATUS_UNSUPPORTED_PROTOCOL":\
(abs((int)status) == SANG_STATUS_DEVICE_ALREADY_EXIST) ? "SANG_STATUS_DEVICE_ALREADY_EXIST":\
(abs((int)status) == SANG_STATUS_DEV_INIT_INCOMPLETE) ? "SANG_STATUS_DEV_INIT_INCOMPLETE":\
(abs((int)status) == SANG_STATUS_API_EVENT_AVAILABLE) ? "SANG_STATUS_API_EVENT_AVAILABLE":\
(abs((int)status) == SANG_STATUS_REGISTRY_ERROR) ? "SANG_STATUS_REGISTRY_ERROR":\
(abs((int)status) == SANG_STATUS_CAN_NOT_STOP_DEVICE_WHEN_ALREADY_STOPPED) ? "SANG_STATUS_CAN_NOT_STOP_DEVICE_WHEN_ALREADY_STOPPED":\
(abs((int)status) == SANG_STATUS_CAN_NOT_RUN_TWO_PORT_CMDS_AT_THE_SAME_TIME) ? "SANG_STATUS_CAN_NOT_RUN_TWO_PORT_CMDS_AT_THE_SAME_TIME":\
(abs((int)status) == SANG_STATUS_ASSOCIATED_IRP_SYSTEM_BUFFER_NULL_ERROR) ? "SANG_STATUS_ASSOCIATED_IRP_SYSTEM_BUFFER_NULL_ERROR":\
(abs((int)status) == SANG_STATUS_STRUCTURE_SIZE_MISMATCH_ERROR) ? "SANG_STATUS_STRUCTURE_SIZE_MISMATCH_ERROR":\
(abs((int)status) == SANG_STATUS_INVALID_IRQL) ? "SANG_STATUS_INVALID_IRQL":\
(abs((int)status) == SANG_STATUS_NO_DATA_AVAILABLE) ? "SANG_STATUS_NO_DATA_AVAILABLE":\
(abs((int)status) == SANG_STATUS_IO_PENDING) ? "SANG_STATUS_IO_PENDING":\
(abs((int)status) == SANG_STATUS_APIPOLL_TIMEOUT) ? "SANG_STATUS_APIPOLL_TIMEOUT":\
(abs((int)status) == SANG_STATUS_NO_FREE_BUFFERS) ? "SANG_STATUS_NO_FREE_BUFFERS":\
(abs((int)status) == SANG_STATUS_OPTION_NOT_SUPPORTED) ? "SANG_STATUS_OPTION_NOT_SUPPORTED":\
"Status Unknown"

#define SANG_SUCCESS(status)    (status == SANG_STATUS_SUCCESS)
#define SANG_ERROR(status)      (!SANG_SUCCESS(status))

#if defined(__WINDOWS__)
#if defined(WAN_KERNEL) || defined(USE_SANGOMA_ERRNO)
/*
    Cross-Platform return codes.
    SOME of these return codes are defined in errno.h, but not ALL of them.
*/
# undef EFAULT
# undef EBUSY
# undef ENODEV
# undef EINVAL
# undef EIO
# undef EPFNOSUPPORT
# undef EPROTONOSUPPORT
# undef ENOMEM
# undef EEXIST
# undef ENOBUFS
# undef EOPNOTSUPP
# undef ENXIO
# undef EAGAIN
# undef EFBIG

# define ETIMEDOUT              SANG_STATUS_GENERAL_ERROR
# define EFAULT             SANG_STATUS_GENERAL_ERROR
# define EBUSY              SANG_STATUS_DEVICE_BUSY
# define ENODEV             SANG_STATUS_INVALID_DEVICE
# define EINVAL             SANG_STATUS_INVALID_PARAMETER
# define EIO                SANG_STATUS_IO_ERROR
# define EPFNOSUPPORT       SANG_STATUS_UNSUPPORTED_FUNCTION
# define EPROTONOSUPPORT    SANG_STATUS_UNSUPPORTED_PROTOCOL
# define ENOMEM             SANG_STATUS_FAILED_ALLOCATE_MEMORY
# define EEXIST             SANG_STATUS_DEVICE_ALREADY_EXIST
# define ENOBUFS            SANG_STATUS_NO_FREE_BUFFERS /* no free tx or rx buffers */
# define EOPNOTSUPP         SANG_STATUS_OPTION_NOT_SUPPORTED
# define ENXIO              EFAULT
# define ENETDOWN           SANG_STATUS_LINE_DISCONNECTED
# define EAGAIN             SANG_STATUS_DEVICE_BUSY
# define EFBIG              SANG_STATUS_TX_DATA_TOO_LONG
# define EAFNOSUPPORT       SANG_STATUS_UNSUPPORTED_FUNCTION
#endif
#endif /* __WINDOWS */

#endif/* __WANPIPE_API_HDR__ */