4.2.2.7 CAPI_GET_PROFILE

Applications call CAPI_GET_PROFILE to retrieve capability information from COMMON-ISDN-API. COMMON-ISDN-APIcopies information about implemented features, the total number of controllers, and protocols supported by the requested controller to a 64-byte buffer passed by the calling application. The application must ignore unknown bits. COMMON-ISDN-APIsets reserved fields to zero. CAPI_GET_PROFILE fills the buffer with the following structure:

TypeDescription

2 bytes

number of installed controllers, least significant byte first

2 bytes

number of supported B-channels, least significant byte first

4 bytes

Global Options (bit field):

 

[0]: internal controller supported

 

[1]: external equipment supported

 

[2]: Handset supported (external equipment must also be set)

 

[3]: DTMF supported

 

[4]: Supplementary Services (see Part III)

 

[5]: channel allocation supported (leased lines)

 

[6]: parameter B channel operation supported

 

[7]: Line Interconnect supported

 

[8]...[31]: reserved

4 bytes

B1 protocol support (bit field):

 

[0]: 64 kbit/s with HDLC framing, always set.

 

[1]: 64 kbit/s bit-transparent operation with byte framing

 

from the network

 

[2]: V.110 asynchronous operation with start/stop byte

 

framing

 

[3]: V.110 synchronous operation with HDLC framing

 

[4]: T.30 modem for fax group 3

 

[5]: 64 kbit/s inverted with HDLC framing.

 

[6]: 56 kbit/s bit-transparent operation with byte framing

 

from the network

 

[7]: Modem with all negotiations

 

[8]: Modem asynchronous operation with start/stop byte

 

framing

 

[9]: Modem synchronous operation with HDLC framing

 

[10]...[31]: reserved

4 bytes

B2 protocol support (bit field):

 

[0]: ISO 7776 (X.75 SLP), always set

 

[1]: Transparent

 

[2]: SDLC

 

[3]: LAPD in accordance with Q.921 for D-channel X.25

 

(SAPI 16)

 

[4]: T.30 for fax group 3

 

[5]: Point-to-Point Protocol (PPP)

 

[6]: Transparent (ignoring framing errors of B1 protocol)

 

[7]: Modem error correction and compression (V.42 bis or

 

MNP5)

 

[8]: ISO 7776 (X.75 SLP) modified supporting V.42 bis

 

compression

 

[9]: V.120 asynchronous mode

 

[10]: V.120 asynchronous mode supporting V.42 bis

 

[11]: V.120 bit-transparent mode

 

[12]: LAPD in accordance with Q.921 including free SAPI

 

selection

 

[13]...[31]: reserved

4