PHONECAPS 구조체(tapi.h)

아티클
08/26/2023

PHONECAPS 구조는 휴대폰 디바이스의 기능을 설명합니다. phoneGetDevCaps 및 TSPI_phoneGetDevCaps 함수는 이 구조를 반환합니다.

구문

typedef struct phonecaps_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwProviderInfoSize;
  DWORD dwProviderInfoOffset;
  DWORD dwPhoneInfoSize;
  DWORD dwPhoneInfoOffset;
  DWORD dwPermanentPhoneID;
  DWORD dwPhoneNameSize;
  DWORD dwPhoneNameOffset;
  DWORD dwStringFormat;
  DWORD dwPhoneStates;
  DWORD dwHookSwitchDevs;
  DWORD dwHandsetHookSwitchModes;
  DWORD dwSpeakerHookSwitchModes;
  DWORD dwHeadsetHookSwitchModes;
  DWORD dwVolumeFlags;
  DWORD dwGainFlags;
  DWORD dwDisplayNumRows;
  DWORD dwDisplayNumColumns;
  DWORD dwNumRingModes;
  DWORD dwNumButtonLamps;
  DWORD dwButtonModesSize;
  DWORD dwButtonModesOffset;
  DWORD dwButtonFunctionsSize;
  DWORD dwButtonFunctionsOffset;
  DWORD dwLampModesSize;
  DWORD dwLampModesOffset;
  DWORD dwNumSetData;
  DWORD dwSetDataSize;
  DWORD dwSetDataOffset;
  DWORD dwNumGetData;
  DWORD dwGetDataSize;
  DWORD dwGetDataOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
  DWORD dwDeviceClassesSize;
  DWORD dwDeviceClassesOffset;
  DWORD dwPhoneFeatures;
  DWORD dwSettableHandsetHookSwitchModes;
  DWORD dwSettableSpeakerHookSwitchModes;
  DWORD dwSettableHeadsetHookSwitchModes;
  DWORD dwMonitoredHandsetHookSwitchModes;
  DWORD dwMonitoredSpeakerHookSwitchModes;
  DWORD dwMonitoredHeadsetHookSwitchModes;
  GUID  PermanentPhoneGuid;
} PHONECAPS, *LPPHONECAPS;

멤버

dwTotalSize

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

dwNeededSize

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

dwUsedSize

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

dwProviderInfoSize

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

dwProviderInfoOffset

구조체의 시작 부분에서 서비스 공급자별 정보를 포함하는 고정 크기 필드로 오프셋됩니다.

이 멤버는 공급업체 이름 및 하드웨어 및 소프트웨어의 버전 번호와 같은 공급자 하드웨어 및/또는 소프트웨어에 대한 정보를 제공합니다. 이 정보는 사용자가 공급자와 관련된 문제가 있는 고객 서비스를 호출해야 하는 경우에 유용할 수 있습니다. 필드의 크기는 dwProviderInfoSize로 지정됩니다.

dwPhoneInfoSize

전화 관련 정보의 크기(바이트)입니다. 전화 관련 정보가 문자열에 대한 포인터인 경우 크기에 null 종결자가 포함되어야 합니다.

dwPhoneInfoOffset

구조체의 시작 부분에서 전화 관련 정보를 포함하는 고정 크기 디바이스 필드로 오프셋됩니다.

이 멤버는 휴대폰 디바이스 제조업체, 모델 이름, 소프트웨어 버전 등 연결된 휴대폰 디바이스에 대한 정보를 제공합니다. 이 정보는 사용자가 전화와 관련된 문제가 있는 고객 서비스에 전화해야 하는 경우에 유용할 수 있습니다. 필드의 크기는 dwPhoneInfoSize로 지정됩니다.

dwPermanentPhoneID

시스템 구성에서 휴대폰 디바이스가 알려진 영구 식별자입니다.

dwPhoneNameSize

null 종결자를 포함하여 휴대폰의 구성 가능한 이름 크기(바이트)입니다.

dwPhoneNameOffset

구조체의 시작 부분에서 이 휴대폰 디바이스의 사용자 구성 가능 이름을 포함하는 고정 크기 디바이스 필드로 오프셋합니다. 이 이름은 휴대폰 디바이스의 서비스 공급자를 구성할 때 사용자가 구성할 수 있으며 사용자의 편의를 위해 제공됩니다. 필드의 크기는 dwPhoneNameSize로 지정됩니다.

dwStringFormat

이 휴대폰 디바이스에서 사용할 문자열 형식입니다. 이 멤버는 STRINGFORMAT_ 상수 중 하나를 사용합니다.

dwPhoneStates

PHONE_STATE 메시지에서 애플리케이션에 알림을 받을 수 있는 이 휴대폰 디바이스의 상태 변경 내용입니다. 이 멤버는 PHONESTATE_ 상수 중 하나 이상입니다.

dwHookSwitchDevs

휴대폰의 후크위치 디바이스. 이 멤버는 PHONEHOOKSWITCHDEV_ 상수 중 하나를 사용합니다.

dwHandsetHookSwitchModes

핸드셋의 후크위치 모드입니다. 멤버는 hookswitch 디바이스가 dwHookSwitchDevs에 나열된 경우에만 의미가 있습니다. PHONEHOOKSWITCHMODE_ 상수 중 하나를 사용합니다.

dwSpeakerHookSwitchModes

스피커의 후크위치 모드입니다. 멤버는 hookswitch 디바이스가 dwHookSwitchDevs에 나열된 경우에만 의미가 있습니다. PHONEHOOKSWITCHMODE_ 상수 중 하나를 사용합니다.

dwHeadsetHookSwitchModes

헤드셋의 후크위치 모드입니다. 멤버는 hookswitch 디바이스가 dwHookSwitchDevs에 나열된 경우에만 의미가 있습니다. PHONEHOOKSWITCHMODE_ 상수 중 하나를 사용합니다.

dwVolumeFlags

휴대폰 디바이스 스피커 구성 요소의 볼륨 설정 기능입니다. 위치 PHONEHOOKSWITCHDEV_ 비트가 TRUE이면 phoneSetVolume을 사용하여 해당 후크위치 디바이스의 스피커 구성 요소 볼륨을 조정할 수 있습니다.

dwGainFlags

휴대폰 디바이스의 마이크 구성 요소의 게인 설정 기능입니다. PHONEHOOKSWITCHDEV_ 비트 위치가 TRUE이면 phoneSetGain을 사용하여 해당 후크위치 디바이스의 마이크 구성 요소 볼륨을 조정할 수 있습니다.

dwDisplayNumRows

휴대폰 디스플레이의 행 수를 설명하여 휴대폰 디바이스의 기능을 표시합니다. dwDisplayNumRows 및 dwDisplayNumColumns 멤버는 모두 디스플레이가 없는 휴대폰 디바이스에 대해 0입니다.

dwDisplayNumColumns

휴대폰 디스플레이의 열 수를 설명하여 휴대폰 디바이스의 기능을 표시합니다. dwDisplayNumRows 및 dwDisplayNumColumns 멤버는 모두 디스플레이가 없는 휴대폰 디바이스에 대해 0입니다.

dwNumRingModes

휴대폰 디바이스의 링 기능. 휴대 전화는 dwNumRingModes 에서 1, 2로 식별 된 다른 링 패턴으로 dwNumRingModes 에서 1을 뺀 값으로 울릴 수 있습니다. 이 멤버의 값이 0이면 응용 프로그램에서 휴대폰의 링 모드를 제어할 수 없습니다. 이 멤버의 값이 0보다 큰 경우 서비스 공급자가 지원하는 무음 외에 링 모드 수를 나타냅니다. phoneGetRing의 lpdwRingMode 매개 변수 또는 phoneSetRing의 dwRingMode 매개 변수에 있는 값 0은 무음(휴대폰이 울리지 않거나 렁이면 안 됨)을 나타내며 dwRingMode 값 1~dwNumRingModes는 전화 장치에 유효한 링 모드입니다.

dwNumButtonLamps

TAPI에서 검색할 수 있는 휴대폰 디바이스의 단추/램프 수입니다. 단추/램프는 식별자에 의해 식별됩니다. 유효한 단추/램프 식별자 범위는 0에서 dwNumButtonLamps 에서 1을 뺀 값입니다. 키패드 단추 '0', '9', '*' 및 '#'에는 식별자 0~12가 할당됩니다.

dwButtonModesSize

단추 모드 배열의 크기(바이트)입니다.

dwButtonModesOffset

이 구조체의 시작 부분에서 휴대폰 단추의 단추 모드가 포함된 고정 크기 필드로 오프셋됩니다. 배열은 단추/램프 식별자로 인덱싱됩니다. 이 배열은 PHONEBUTTONMODE_ 상수를 사용합니다. 배열의 크기는 dwButtonModesSize로 지정됩니다.

dwButtonFunctionsSize

단추 함수 필드의 크기(바이트)입니다.

dwButtonFunctionsOffset

이 구조체의 시작 부분에서 휴대폰 단추의 단추 기능을 포함하는 고정 크기 필드로 오프셋됩니다. 배열은 단추/램프 식별자로 인덱싱됩니다. 이 배열은 PHONEBUTTONFUNCTION_ 상수를 사용합니다. 배열의 크기는 dwButtonFunctionsSize로 지정됩니다.

dwLampModesSize

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

dwLampModesOffset

이 구조체의 시작 부분에서 휴대폰 램프의 램프 모드가 포함된 고정 크기 필드로 오프셋됩니다. 배열은 단추/램프 식별자로 인덱싱됩니다. 이 배열은 PHONELAMPMODE_ 상수를 사용합니다. 배열의 크기는 dwLampModesSize로 지정됩니다.

dwNumSetData

휴대폰 디바이스의 다양한 다운로드 영역 수입니다. 다른 영역은 데이터 ID 0, 1, dwNumSetData 에서 1을 뺀 값을 사용하여 참조됩니다. 이 멤버가 0이면 휴대폰에서 다운로드 기능을 지원하지 않습니다.

dwSetDataSize

데이터 크기 배열의 크기(바이트)입니다.

dwSetDataOffset

이 구조체의 시작 부분에서 휴대폰 다운로드 데이터 영역의 크기(바이트)를 포함하는 고정 크기 필드로 오프셋됩니다. 데이터 식별자로 인덱싱된 DWORD 크기의 요소가 있는 배열입니다. 배열의 크기는 dwSetDataSize로 지정됩니다.

dwNumGetData

휴대폰 디바이스의 다른 업로드 영역 수입니다. 다른 영역은 데이터 ID 0, 1, dwNumGetData 에서 1을 뺀 값을 사용하여 참조됩니다. 이 필드가 0이면 휴대폰에서 업로드 기능을 지원하지 않습니다.

dwGetDataSize

데이터 크기 배열의 크기(바이트)입니다.

dwGetDataOffset

이 구조체의 시작 부분에서 휴대폰 업로드 데이터 영역의 크기(바이트)를 포함하는 고정 크기 필드로 오프셋됩니다. 데이터 식별자로 인덱싱된 DWORD 크기의 요소가 있는 배열입니다. 배열의 크기는 dwGetDataSize로 지정됩니다.

dwDevSpecificSize

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

dwDevSpecificOffset

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

dwDeviceClassesSize

지원되는 디바이스 클래스 식별자의 크기(바이트)입니다.

dwDeviceClassesOffset

이 구조체의 시작 부분에서 phoneGetID와 함께 사용하기 위해 이 디바이스에서 지원되는 디바이스 클래스 식별자로 구성된 문자열로 오프셋합니다. 식별자는 NULLs로 구분되고 목록의 마지막 식별자 뒤에 두 개의 NULL이 잇습니다. 필드의 크기는 dwDeviceClassesSize로 지정됩니다.

dwPhoneFeatures

휴대폰에서 호출할 수 있는 전화 통신 API 기능을 나타내는 플래그입니다. 0은 해당 기능이 구현되지 않았으며 휴대폰의 애플리케이션에서 호출할 수 없음을 나타냅니다. 하나는 디바이스 상태 및 기타 요인에 따라 기능이 호출될 수 있음을 나타냅니다. 이 멤버는 PHONEFEATURE_ 상수를 사용합니다.

dwSettableHandsetHookSwitchModes

phoneSetHookSwitch를 사용하여 핸드셋에서 설정할 수 있는 값을 PHONEHOOKSWITCHMODE_.

dwSettableSpeakerHookSwitchModes

phoneSetHookSwitch를 사용하여 스피커폰에서 설정할 수 있는 값을 PHONEHOOKSWITCHMODE_.

dwSettableHeadsetHookSwitchModes

phoneSetHookSwitch를 사용하여 헤드셋에서 설정할 수 있는 값을 PHONEHOOKSWITCHMODE_.

dwMonitoredHandsetHookSwitchModes

PHONE_STATE 메시지 및 phoneGetHookSwitch에서 핸드셋에 대해 검색 및 보고할 수 있는 값을 PHONEHOOKSWITCHMODE_.

dwMonitoredSpeakerHookSwitchModes

PHONE_STATE 메시지 및 phoneSetHookSwitch에서 스피커폰에 대해 검색 및 보고할 수 있는 값을 PHONEHOOKSWITCHMODE_.

dwMonitoredHeadsetHookSwitchModes

PHONE_STATE 메시지 및 phoneSetHookSwitch에서 헤드셋에 대해 검색 및 보고할 수 있는 값을 PHONEHOOKSWITCHMODE_.