PHONEBUTTONINFO 구조체(tapi.h)

아티클
03/02/2024

PHONEBUTTONINFO 구조체에는 휴대폰 디바이스의 단추에 대한 정보가 포함됩니다. 이 구조체는 여러 TAPI 및 TSPI 함수에서 사용됩니다.

구문

typedef struct phonebuttoninfo_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwButtonMode;
  DWORD dwButtonFunction;
  DWORD dwButtonTextSize;
  DWORD dwButtonTextOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
  DWORD dwButtonState;
} PHONEBUTTONINFO, *LPPHONEBUTTONINFO;

멤버

dwTotalSize

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

dwNeededSize

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

dwUsedSize

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

dwButtonMode

단추의 모드 또는 일반 사용 클래스입니다. 이 멤버는 PHONEBUTTONMODE_ 상수 중 하나를 사용합니다.

dwButtonFunction

단추에 할당된 함수입니다. 이 멤버는 PHONEBUTTONFUNCTION_ 상수 중 하나를 사용합니다.

dwButtonTextSize

단추의 설명 텍스트 크기(바이트)입니다.

dwButtonTextOffset

이 구조체의 시작 부분에서 이 단추에 대한 설명 텍스트를 포함하는 고정 크기 필드로 오프셋됩니다. 이 정보의 형식은 휴대폰 장치 기능의 dwStringFormat 멤버에 지정된 대로 지정됩니다. 필드의 크기는 dwButtonTextSize로 지정됩니다.

dwDevSpecificSize

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

dwDevSpecificOffset

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

dwButtonState

phoneGetButtonInfo 함수의 경우 이 필드는 PHONEBUTTONSTATE_ 상수를 사용하여 단추의 현재 상태를 나타냅니다. 이 필드는 phoneSetButtonInfo 함수에서 무시됩니다.

설명

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

이전 애플리케이션은 PHONEBUTTONINFO 구조에서 이 필드 없이 컴파일되고 새 크기보다 작은 SIZEOF PHONEBUTTONINFO를 사용합니다. 애플리케이션은 phoneOpen 함수를 사용하여 dwAPIVersion 매개 변수를 전달합니다. 이 함수는 이 상황을 처리하는 데 TAPI의 지침에 사용할 수 있습니다. 애플리케이션이 지정된 dwAPIVersion에 정의된 대로 구조체의 고정 부분 크기보다 작은 dwTotalSize를 전달하면 PHONEERR_STRUCTURETOOSMALL 반환됩니다. TSPI_phoneGetButtonInfo 함수를 호출하기 전에 애플리케이션에서 충분한 메모리를 할당한 경우 TAPI는 dwNeededSize 및 dwUsedSize 멤버를 지정된 API 버전에 있는 구조체의 고정 크기로 설정합니다.

새 API 버전을 지원하는 새 서비스 공급자는 전달된 API 버전을 검사해야 합니다. API 버전이 공급자가 지원하는 가장 높은 버전보다 작은 경우 이전 API 버전에서 지원되지 않는 필드를 서비스 공급자가 채우면 안 됩니다. 이전 구조체의 가변 부분에 해당하기 때문에 서비스 공급자는 이전 API 버전에서 지원되지 않는 필드를 채우지 않아야 합니다.

새 애플리케이션은 협상된 API 버전을 인식해야 하며 협상된 API 버전에 대한 구조체의 고정 부분의 원래 끝을 벗어나는 고정 부분의 필드 내용을 검사하지 않아야 합니다.