PHONESTATUS 구조체(tapi.h)

아티클
03/08/2023

PHONESTATUS 구조는 휴대폰 디바이스의 현재 상태 설명합니다. phoneGetStatus 및 TSPI_phoneGetStatus 함수는 이 구조를 반환합니다.

구문

typedef struct phonestatus_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwStatusFlags;
  DWORD dwNumOwners;
  DWORD dwNumMonitors;
  DWORD dwRingMode;
  DWORD dwRingVolume;
  DWORD dwHandsetHookSwitchMode;
  DWORD dwHandsetVolume;
  DWORD dwHandsetGain;
  DWORD dwSpeakerHookSwitchMode;
  DWORD dwSpeakerVolume;
  DWORD dwSpeakerGain;
  DWORD dwHeadsetHookSwitchMode;
  DWORD dwHeadsetVolume;
  DWORD dwHeadsetGain;
  DWORD dwDisplaySize;
  DWORD dwDisplayOffset;
  DWORD dwLampModesSize;
  DWORD dwLampModesOffset;
  DWORD dwOwnerNameSize;
  DWORD dwOwnerNameOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
  DWORD dwPhoneFeatures;
} PHONESTATUS, *LPPHONESTATUS;

멤버

dwTotalSize

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

dwNeededSize

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

dwUsedSize

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

dwStatusFlags

이 휴대폰 디바이스의 상태 플래그입니다. 이 멤버는 PHONESTATUSFLAGS_ 상수 중 하나를 사용합니다.

dwNumOwners

휴대폰에 대한 소유자 권한이 있는 애플리케이션 모듈의 수입니다.

dwNumMonitors

휴대폰에 대한 모니터 권한이 있는 애플리케이션 모듈 수입니다.

dwRingMode

휴대폰 디바이스의 현재 링 모드입니다.

dwRingVolume

휴대폰 디바이스의 현재 링 볼륨입니다. 이는 0x00000000(무음)와 0x0000FFFF(최대 볼륨) 사이의 값입니다.

dwHandsetHookSwitchMode

휴대폰 핸드셋의 현재 후크위치 모드입니다. 이 멤버는 PHONEHOOKSWITCHMODE_ 상수 중 하나를 사용합니다.

dwHandsetVolume

휴대폰 핸드셋 장치의 현재 스피커 볼륨입니다. 이는 0x00000000(무음)와 0x0000FFFF(최대 볼륨) 사이의 값입니다.

dwHandsetGain

휴대폰의 핸드셋 장치의 현재 마이크 게인입니다. 이는 0x00000000(무음)와 0x0000FFFF(최대 게인) 사이의 값입니다.

dwSpeakerHookSwitchMode

휴대폰 스피커폰의 현재 후크위치 모드입니다. 이 멤버는 PHONEHOOKSWITCHMODE_ 상수 중 하나를 사용합니다.

dwSpeakerVolume

휴대폰 스피커 장치의 현재 스피커 볼륨입니다. 이는 0x00000000(무음)와 0x0000FFFF(최대 볼륨) 사이의 값입니다.

dwSpeakerGain

휴대폰 스피커 장치의 현재 마이크 게인입니다. 이는 0x00000000(무음)와 0x0000FFFF(최대 게인) 사이의 값입니다.

dwHeadsetHookSwitchMode

휴대폰 헤드셋의 현재 후크위치 모드입니다. 이 멤버는 PHONEHOOKSWITCHMODE_ 상수 중 하나를 사용합니다.

dwHeadsetVolume

휴대폰 헤드셋 장치의 현재 스피커 볼륨입니다. 이는 0x00000000(무음)와 0x0000FFFF(최대 볼륨) 사이의 값입니다.

dwHeadsetGain

휴대폰 헤드셋 장치의 현재 마이크 게인입니다. 이는 0x00000000(무음)와 0x0000FFFF(최대 게인) 사이의 값입니다.

dwDisplaySize

표시 정보의 크기(바이트)입니다.

dwDisplayOffset

이 구조체의 시작 부분에서 휴대폰의 현재 표시 정보가 포함된 고정 크기 필드로 오프셋됩니다. 필드의 크기는 dwDisplaySize로 지정됩니다.

dwLampModesSize

현재 램프 모드 배열의 크기(바이트)입니다.

dwLampModesOffset

이 구조체의 시작 부분에서 휴대폰의 현재 램프 모드가 포함된 고정 크기 필드로 오프셋됩니다. 필드의 크기는 dwLampModesSize로 지정됩니다.

dwOwnerNameSize

null 종결자를 포함하여 현재 소유자의 이름 크기(바이트)입니다.

dwOwnerNameOffset

구조체의 시작 부분에서 휴대폰 디바이스의 현재 소유자인 애플리케이션의 이름을 포함하는 고정 크기 필드로 오프셋됩니다. 이름은 phoneInitialize 또는 phoneInitializeEx 를 사용하여 호출할 때 애플리케이션에서 제공하는 애플리케이션 이름 입니다. 애플리케이션 이름이 제공되지 않은 경우 애플리케이션의 파일 이름이 대신 사용됩니다. 필드의 크기는 dwOwnerNameSize로 지정됩니다. 휴대폰에 현재 소유자가 없는 경우 dwOwnerNameSize 는 0입니다.

dwDevSpecificSize

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

dwDevSpecificOffset

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

dwPhoneFeatures

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