PHONECAPS 구조체(tapi.h)
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_.
PermanentPhoneGuid
이 휴대폰과 영구적으로 연결된 GUID입니다.
설명
디바이스별 확장은 이 데이터 구조의 고정 크기 영역인 DevSpecific(dwDevSpecificSize 및 dwDevSpecificOffset)을 사용해야 합니다.
dwMonitoredHeadsetHookSwitchModes를 통한 dwDeviceClassesSize 멤버는 API 버전이 2.0 이상인 휴대폰 디바이스를 여는 애플리케이션에서만 사용할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 | tapi.h |
추가 정보
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기