phoneSetDisplay 함수(tapi.h)

아티클
03/02/2024

phoneSetDisplay 함수를 사용하면 지정된 열린 휴대폰 디바이스에 지정된 문자열이 표시됩니다.

구문

LONG phoneSetDisplay(
  HPHONE hPhone,
  DWORD  dwRow,
  DWORD  dwColumn,
  LPCSTR lpsDisplay,
  DWORD  dwSize
);

매개 변수

hPhone

열려 있는 휴대폰 디바이스에 대한 핸들입니다. 애플리케이션은 휴대폰의 소유자여야 합니다.

dwRow

새 텍스트를 표시할 디스플레이의 행 위치입니다.

dwColumn

새 텍스트를 표시할 디스플레이의 열 위치입니다.

lpsDisplay

표시 콘텐츠가 저장되는 메모리 위치에 대한 포인터입니다. 표시 정보에는 휴대폰의 디바이스 기능을 설명하는 PHONECAPS 구조의 dwStringFormat 멤버에 지정된 형식이 있어야 합니다.

dwSize

lpsDisplay에서 가리키는 정보의 크기(바이트)입니다. lpsDisplay 매개 변수가 문자열에 대한 포인터인 경우 크기는 null 종결자를 포함해야 합니다.

반환 값

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

PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOTOWNER, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONESTATE, PHONEERR_UNINITIALIZED, PHONEERR_INVALPOINTER, PHONEERR_NOMEM, PHONEERR_INVALPARAM, PHONEERR_RESOURCEUNAVAIL.

설명

지정된 표시 정보는 지정된 위치에서 시작하여 휴대폰의 디스플레이에 기록됩니다. 이 작업은 이전에 표시된 정보를 덮어씁니다. 정보의 양이 디스플레이 크기를 초과하면 정보가 잘립니다. 표시할 수 있는 정보의 크기는 최대(dwNumRows * dwNumColumns) 요소입니다. dwNumRows 및 dwNumColumns는 phoneGetDevCaps에서 반환되는 PHONECAPS 구조에서 사용할 수 있습니다. 0부터 시작합니다.