LINECALLSTATUS 구조체(tapi.h)

  • 아티클

LINECALLSTATUS 구조체는 호출의 현재 상태 설명합니다. 이 구조의 정보는 주소의 디바이스 기능, 호출 애플리케이션의 호출 소유권 및 쿼리되는 호출의 현재 상태에 따라 달라집니다. lineGetCallStatus 및 TSPI_lineGetCallStatus 함수는 LINECALLSTATUS 구조를 반환합니다.

구문

typedef struct linecallstatus_tag {
  DWORD      dwTotalSize;
  DWORD      dwNeededSize;
  DWORD      dwUsedSize;
  DWORD      dwCallState;
  DWORD      dwCallStateMode;
  DWORD      dwCallPrivilege;
  DWORD      dwCallFeatures;
  DWORD      dwDevSpecificSize;
  DWORD      dwDevSpecificOffset;
  DWORD      dwCallFeatures2;
#if ...
  SYSTEMTIME tStateEntryTime;
#else
  WORD       tStateEntryTime[8];
#endif
} LINECALLSTATUS, *LPLINECALLSTATUS;

멤버

dwTotalSize

이 데이터 구조에 할당된 총 크기(바이트)입니다.

dwNeededSize

반환된 모든 정보를 바이트 단위로 유지하는 데 필요한 이 데이터 구조의 크기입니다.

dwUsedSize

유용한 정보를 포함하는 이 데이터 구조의 부분 크기(바이트)입니다.

dwCallState

LINECALLSTATE_ 상수 중 하나를 사용하여 호출의 현재 호출 상태입니다.

dwCallStateMode

dwCallStateMode 멤버의 해석은 호출 상태 종속입니다. 대부분의 경우 값은 0입니다. 다음 표에서는 지정된 dwCallState 값에 대한 dwCallStateMode 형식 을 보여 주었습니다.

dwCallState 의미
LINECALLSTATE_BUSY

LINEBUSYMODE_ 상수
LINECALLSTATE_CONNECTED

LINECONNECTEDMODE_ 상수
LINECALLSTATE_DIALTONE

LINEDIALTONEMODE_ 상수
LINECALLSTATE_DISCONNECTED

LINEDISCONNECTMODE_ 상수
LINECALLSTATE_OFFERING

LINEOFFERINGMODE_ 상수
LINECALLSTATE_SPECIALINFO

LINESPECIALINFO_ 상수

dwCallPrivilege

이 호출에 대한 애플리케이션의 권한입니다. 이 멤버는 하나 이상의 LINECALLPRIVILEGE_ 상수를 사용합니다.

dwCallFeatures

디바이스 기능의 기능 가용성, 현재 호출 상태 및 호출 애플리케이션의 호출 소유권을 고려하여 호출 시 호출할 수 있는 전화 통신 API 함수를 나타내는 플래그입니다. 0은 애플리케이션이 현재 상태의 호출에서 해당 기능을 호출할 수 없음을 나타냅니다. 는 기능을 호출할 수 있음을 나타냅니다. 이 멤버는 LINECALLFEATURE_ 상수를 사용합니다.

dwDevSpecificSize

디바이스별 필드의 크기(바이트)입니다.

dwDevSpecificOffset

구조체의 시작 부분에서 변함없이 크기가 조정된 디바이스별 필드로 오프셋됩니다. 필드의 크기는 dwDevSpecificOffset으로 지정됩니다.

dwCallFeatures2

디바이스 기능의 기능 가용성, 현재 호출 상태 및 호출 애플리케이션의 호출 소유권을 고려하여 호출 시 추가 함수를 호출할 수 있음을 나타냅니다. dwCallFeatures 멤버의 확장입니다. 이 멤버는 LINECALLFEATURE2_ 상수를 사용합니다.

tStateEntryTime

현재 호출 상태가 입력된 협정 세계시입니다.

tStateEntryTime[8]

현재 호출 상태가 입력된 협정 세계시입니다.

설명

디바이스별 확장은 이 데이터 구조의 고정 크기 영역인 DevSpecific(dwDevSpecificSize 및 dwDevSpecificOffset)을 사용해야 합니다.

애플리케이션은 호출의 호출 상태가 변경 될 때마다 LINE_CALLSTATE 메시지를 보냅니다. 이 메시지는 호출의 새 호출 상태만 제공합니다. 호출에 대한 추가 상태 lineGetCallStatus에서 사용할 수 있습니다.

dwCallFeatures2 및 tStateEntryTime 멤버는 API 버전이 2.0 이상인 라인 디바이스를 여는 애플리케이션에서만 사용할 수 있습니다.

요구 사항

요구 사항 값
헤더 tapi.h

추가 정보

LINEDIALPARAMS

LINE_CALLSTATE

TSPI_lineGetCallStatus

lineGetCallStatus