phoneGetData 함수(tapi.h)

phoneGetData 함수는 열린 휴대폰 디바이스의 지정된 위치에서 지정된 버퍼로 정보를 업로드합니다.

구문

LONG phoneGetData(
  HPHONE hPhone,
  DWORD  dwDataID,
  LPVOID lpData,
  DWORD  dwSize
);

매개 변수

hPhone

열려 있는 휴대폰 디바이스에 대한 핸들입니다.

dwDataID

휴대폰 디바이스에서 버퍼를 업로드할 위치입니다.

lpData

데이터를 업로드할 메모리 버퍼에 대한 포인터입니다.

dwSize

데이터 버퍼의 크기(바이트)입니다.

반환 값

요청이 성공하면 0을 반환하고 오류가 발생하면 음수 오류 번호를 반환합니다. 가능한 반환 값은 다음과 같습니다.

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

설명

함수는 휴대폰 디바이스에서 lpData가 가리키는 메모리 영역으로 최대 dwSize 바이트를 업로드합니다. dwSize가 0이면 아무것도 복사되지 않습니다. 각 데이터 영역의 크기는 휴대폰의 디바이스 기능에 나열됩니다.

요구 사항

추가 정보

보조 전화 서비스 기능

TAPI 2.2 참조 개요