LINEDEVSTATUS 구조체(tapi.h)

아티클
08/26/2023

LINEDEVSTATUS 구조는 라인 디바이스의 현재 상태 설명합니다. lineGetLineDevStatus 함수와 TSPI_lineGetLineDevStatus 함수는 LINEDEVSTATUS 구조를 반환합니다.

구문

typedef struct linedevstatus_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwNumOpens;
  DWORD dwOpenMediaModes;
  DWORD dwNumActiveCalls;
  DWORD dwNumOnHoldCalls;
  DWORD dwNumOnHoldPendCalls;
  DWORD dwLineFeatures;
  DWORD dwNumCallCompletions;
  DWORD dwRingMode;
  DWORD dwSignalLevel;
  DWORD dwBatteryLevel;
  DWORD dwRoamMode;
  DWORD dwDevStatusFlags;
  DWORD dwTerminalModesSize;
  DWORD dwTerminalModesOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
  DWORD dwAvailableMediaModes;
  DWORD dwAppInfoSize;
  DWORD dwAppInfoOffset;
} LINEDEVSTATUS, *LPLINEDEVSTATUS;

멤버

dwTotalSize

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

dwNeededSize

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

dwUsedSize

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

dwNumOpens

라인 디바이스에서 열린 활성 수입니다.

dwOpenMediaModes

라인 디바이스가 현재 열려 있는 미디어 형식을 나타내는 비트 배열입니다.

dwNumActiveCalls

유휴 상태, onhold, onholdpendingtransfer 및 onholdpendingconference 이외의 호출 상태의 줄에 대한 호출 수입니다.

dwNumOnHoldCalls

onhold 상태의 줄에 대한 호출 수입니다.

dwNumOnHoldPendCalls

onholdpendingtransfer 또는 onholdpendingconference 상태의 줄에 대한 호출 수입니다.

dwLineFeatures

이 줄에서 현재 사용할 수 있는 줄 관련 함수입니다. 이 멤버는 하나 이상의 LINEFEATURE_ 상수를 사용합니다.

dwNumCallCompletions

줄의 미해결 호출 완료 요청 수입니다.

dwRingMode

라인 디바이스의 현재 링 모드입니다.

dwSignalLevel

선에 있는 연결의 현재 신호 수준입니다. 이 값은 0x0000FFFF(가장 강력한 신호)에 0x00000000(가장 약한 신호) 범위의 값입니다.

dwBatteryLevel

라인 디바이스 하드웨어의 현재 배터리 수준입니다. 이 값은 0x0000FFFF(배터리가 가득 찼습니다)0x00000000(배터리가 비어 있음) 범위의 값입니다.

dwRoamMode

라인 디바이스의 현재 로밍 모드입니다. 이 멤버는 LINEROAMMODE_ 상수 중 하나를 사용합니다.

dwDevStatusFlags

디바이스가 잠겨 있는지 여부와 같은 상태 정보를 나타내는 플래그입니다. LINEDEVSTATUSFLAGS_ 상수의 하나 이상의 멤버로 구성됩니다.

dwTerminalModesSize

현재 터미널 모드 배열을 포함하는 가변 크기 디바이스 필드의 크기(바이트)입니다.

dwTerminalModesOffset

구조체의 시작 부분에서 현재 터미널 모드의 배열(바이트)까지의 오프셋입니다. 이 배열은 0에서 dwNumTerminals 에서 1을 뺀 범위의 터미널 ID로 인덱싱됩니다. 배열의 각 항목은 이 줄에 대한 lineSetTerminal 함수를 사용하여 해당 터미널 집합의 현재 터미널 모드를 지정합니다. 각 항목은 하나 이상의 LINETERMMODE_ 상수를 지정하는 DWORD입니다. 배열의 크기는 dwTerminalModesSize로 지정됩니다.

dwDevSpecificSize

변함없이 크기가 조정된 디바이스별 필드의 크기(바이트)입니다. 디바이스별 정보가 문자열에 대한 포인터인 경우 크기는 null 종결자를 포함해야 합니다.

dwDevSpecificOffset

구조체의 시작 부분에서 디바이스별 필드(바이트)로 오프셋됩니다. 필드의 크기는 dwDevSpecificSize로 지정됩니다.

dwAvailableMediaModes

dwLineFeatures 멤버가 새 호출이 가능하다는 것을 나타내는 경우 이 회선 디바이스에서 만든 새 호출에서 호출할 수 있는 미디어 유형을 나타냅니다. 이 멤버가 0이면 서비스 공급자가 사용할 수 있는 미디어 형식을 모르거나 나타낼 수 없음을 나타냅니다. 이 경우 LINEDEVCAPS의 dwMediaModes 멤버에 표시된 미디어 유형 중 하나 또는 전부를 사용할 수 있습니다.

dwAppInfoSize

선이 열려 있는 애플리케이션을 식별하는 배열의 크기(바이트)입니다.

dwAppInfoOffset

구조체의 시작 부분에서 LINEAPPINFO 구조체의 배열로 오프셋됩니다. dwNumOpens 멤버는 배열의 요소 수를 나타냅니다. 배열의 각 요소는 선이 열려 있는 애플리케이션을 식별합니다. 배열의 크기는 dwAppInfoSize로 지정됩니다.