Chapter 9 TAPI 객체
이것은 쿼리와 셋 정보 요청들 모두의 TAPI 오브젝트들을 위한 OID들을 정의한다. 이러한 OID 들은 유저-모드 TAPI 서비스 제공자들과 아래의 WAN NIC 미니포트 들사이의 요청 인터페이스를 정의한다. 각각의 그런 요청들은 NDITAPI와 NDISWAN을 통해서 목표 미니포트까지 간다.
특별히 이러한 OID 요청들이 발생하는 유저-모드 서비스 제공자들에 관한 최상위-레벨 TAPI 컴포넌트들에 관한 더 많은 정보는, Win32 SDK를 봐라.
아래의 차트는 WAN 네트워크 상에서 TAPI를 지원하는 NIS 드라이버와 NIC들을 위한 추가적인 특성들을 얻기 위해서 사용된 OID들을 요약한다.
| Q |
S |
Name |
| |
|
의무적인 OID_TAPI_XXX |
| M |
OID_TAPI_ANSWER
응답 |
| M |
OID_TAPI_CLOSE
닫기 |
| M |
OID_TAPI_CLOSE_CALL
호출 닫기 |
| M |
OID_TAPI_CONDITIONAL_MEDIA_DETECTION
조건부의 미디어 검출 |
| M |
OID_TAPI_DROP
드랍 |
| M |
|
OID_TAPI_GET_ADDRESS_CAPS
주소 능력들 얻기 |
| M |
OID_TAPI_GET_ADDRESS_ID
주소 ID 얻기 |
| M |
OID_TAPI_GET_ADDRESS_STATUS
주소 상태 얻기 |
| M |
OID_TAPI_GET_CALL_ADDRESS_ID
호출 주소 ID 얻기 |
| M |
OID_TAPI_GET_CALL_INFO
호출 정보 얻기 |
| M |
OID_TAPI_GET_CALL_STATUS
호출 상태 얻기 |
| M |
OID_TAPI_GET_DEV_CAPS
장치 능력들 얻기 |
| M |
OID_TAPI_GET_ID
ID 얻기 |
| M |
OID_TAPI_GET_LINE_DEV_STATUS
라인 장치 상태 얻기 |
| M |
OID_TAPI_MAKE_CALL
호출 만들기 |
| M |
OID_TAPI_OPEN
열기 |
| M |
OID_TAPI_PROVIDER_INITIALIZE
제공자 초기화 |
| |
M |
OID_TAPI_PROVIDER_SHUTDOWN
제공자 셧다운 |
| M |
OID_TAPI_SET_APP_SPECIFIC
어플리케이션 특정 번호 설정하기 |
| M |
OID_TAPI_SET_CALL_PARAMS
호출 파라미터 설정하기 |
| M |
OID_TAPI_SET_DEFAULT_MEDIA_DETECTION
디폴트 미디어 검출 설정하기 |
| M |
OID_TAPI_SET_MEDIA_MODE
미디어 모드 설정하기 |
| M |
OID_TAPI_SET_STATUS_MESSAGES
상태 메시지 설정하기 |
| |
추가적인 OID_TAPI_XXX |
| O |
OID_TAPI_ACCEPT
수락하기 |
| O |
|
OID_TAPI_CONFIG_DIALOG
다이얼로그 구성 |
| O |
OID_TAPI_DEV_SPECIFIC
장치 특정 |
| |
O |
OID_TAPI_DIAL
지정된 호출을 위한 지정된 번호 전화걸기(Dial) |
| O |
|
OID_TAPI_GET_DEV_CONFIG
장치 구성 얻기 |
| O |
OID_TAPI_GET_EXTENSION_ID
확장 ID 얻기 |
| O |
OID_TAPI_NEGOTIATE_EXT_VERSION
최상위(Highest) 수락할수 있는 버전 확장 리턴 |
| |
O |
OID_TAPI_SET_DEV_CONFIG
장치 구성 설정하기 |
| O |
OID_TAPI_SECURE_CALL
호출 안전 보장하기 |
| O |
OID_TAPI_SELECT_EXT_VERSION
확장 버전 선택하기 |
| O |
OID_TAPI_SEND_USER_USER_INFO
사용자에게 사용자 정보 보내기 |
다른 OID들과 비교해서, 정의된 TAPI OID 값들은 각각의 OID가 요구되는 것인지 추가적인 것이지 알리지 않는다. TAPI OID 요청들을 위한 정보 버퍼의 길이는 OID-특정 구조체에 따라 다양하다. 몇명 OID-특정 구조체의 인스턴스는 또한 크기에서, 특별히 나중에 설명된 타입 VAR_STRING의 멤버를 가지는 TAPI-정의된 구조체들에 대해서 다양하다.
WAN NIC 미니포트들은 앞 차트에서 의무적(Mandatory)으로 붙여진 OID들을 지원해야한다. 주어진 미니포트에 확장(extent)은 드라이버 작성자들의 재량과 NIC의 능력들에 의존하는 앞의 차트에 있는 이러한 레이블된(labeled) 추가적인(Optional)것을 지원한다.
기능적인 요구들은 몇개의 TAPI OID 요청들에 대해서는 꽤 간단하다. 예를들면, OID_TAPI_SET_APP_SPECIFIC 요청들은 NIC 드라이버가 단지 ULONG 값을 나중에 OID_TAPI_GET_CALL_INFO 요청에 의해서 회수될 수 있는, 지정된 호출 인스턴스에 연관할것을 요구한다. NIC 드라이버 작성자가 무시할 것을 선택하는 요청들은 NDIS_STATUS_TAPI_OPERATIONUNAVAIL 상태 코드를 가지고 완성되어야 한다.
NIC 드라이버는 LINE_ADDRESS_CAPS 구조체에 있는 ulAddrCapFlags 멤버에 있는것처럼 몇몇의 OID_TAPI_GET_XXX 요청들에 대한 구조체에 있는 특정 비트들을 설정하고 지움으로써, 라인, 주소 또는 호출 상태에 의존하는 시간 넘어로 다양할지 모르는 그것이 지원하는 요청들을 알릴 수 있다.
LINE_ADDRESS_CAPS 의 선언과 WAN 미니포트들이 TAPI 상태를 유지하는 다른 시스템-정의된 구조체에 대해서는 ndistapi.h를 봐라. 이러한 구조체들에 대한 더 많은 정보는 Win32 SDK를 봐라.
TAPI Type VAR_STRING
몇몇의 OID_TAPI_XXX 에 대해서, 미니포드는 OID-특정 구조체로된(structured) 정보 버퍼에 주어진다. 하나 이상의 이러한 TAPI 구조체들은 아래에 정의된 또한 구조체로된 버퍼인 타입 VAR_STRING 의 멤버를 가진다.
typedef struct _VAR_STRING {
ULONG ulTotalSize;
ULONG ulNeededSize;
ULONG ulUsedSize;
ULONG ulStringFormat;
ULONG ulStringSize;
ULONG ulStringOffset;
} VAR_STRING, *PVAR_STRING;
|
이러한 구조체의 멤버들은 아래의 정보를 포함한다.:
- ulTotalSize
- 버퍼된 스트링을 포함하는 버퍼의 바이트 전체크기.
- ulNeededSize
- 특정한 스트링을 포함하기위해서 필요한 버퍼의 바이트 크기들. 예를들면, 만약 프로토콜-지원된 버퍼가 너무 짧아서 요청된 스트링을 포함할 수 없다면 아래의 드라이버는 이 값을 설정한다.
- ulUsedSize
- 실제적으로 사용된 주어진 버퍼의 바이트 수.
- ulStringFormat
어떻게 버퍼된 스트링이 아래중의 하나로 해석되어야하는지를 지정한다.
STRINGFORMAT_ASCII
STRINGFORMAT_DBCS
STRINGFORMAT_UNICODE
STRINGFORMAT_BINARY
- ulStringSize
- 주어진 버퍼된 스트링에 있는 바이트 수.
- ulStringOffset
- 스트링이 시작에서 이 버퍼내의 옵셋
아래의 섹션들은 앞의 차트와 그들의 연관된 TAPI 구조체에 있는 리스트된 OID_XXX를 설명한다. 만약 있다면, 더 충분히
|