phoneDevSpecific 함수(tapi.h)

아티클
03/13/2024

phoneDevSpecific 함수는 다른 TAPI 함수에 설명되지 않은 기능을 제공하기 위해 전화 통신 API 구현을 사용하도록 설정하는 일반 확장 메커니즘으로 사용됩니다. 이러한 확장의 의미는 디바이스별로 다릅니다.

구문

LONG phoneDevSpecific(
  HPHONE hPhone,
  LPVOID lpParams,
  DWORD  dwSize
);

매개 변수

hPhone

휴대폰 디바이스에 대한 핸들입니다.

lpParams

매개 변수 블록을 보유하는 데 사용되는 메모리 영역에 대한 포인터입니다. 해석은 디바이스별로 다릅니다. 매개 변수 블록의 내용은 TAPI에 의해 서비스 공급자에게 변경되지 않고 전달됩니다.

dwSize

매개 변수 블록 영역의 크기(바이트)입니다.

반환 값

함수가 비동기적으로 완료된 경우 양수 요청 식별자를 반환하고 오류가 발생하면 음수 오류 번호를 반환합니다. 함수가 성공하면 해당 PHONE_REPLY 메시지의 dwParam2 매개 변수가 0이거나 오류가 발생하면 음수 오류 번호입니다. 가능한 반환 값은 다음과 같습니다.

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONFAILED.

추가 반환 값은 디바이스별로 다릅니다.

설명

이 작업은 제네릭 매개 변수 프로필을 제공합니다. 매개 변수 블록의 해석은 디바이스별로 다릅니다. 디바이스별 표시 및 회신은 PHONE_DEVSPECIFIC 메시지를 사용해야 합니다.

서비스 공급자는 이 작업에 사용할 매개 변수를 정의하여 디바이스별 함수에 대한 액세스를 제공할 수 있습니다. 이러한 디바이스별 확장을 사용하려는 애플리케이션은 정의된 확장을 설명하는 디바이스별(공급업체별) 설명서를 참조해야 합니다. 일반적으로 이러한 디바이스별 확장을 사용하는 애플리케이션은 다른 서비스 공급자 환경에서 작동하도록 이식할 수 없습니다.