fungsi phoneSetDisplay (tapi.h)

Fungsi phoneSetDisplay menyebabkan string yang ditentukan ditampilkan pada perangkat telepon terbuka yang ditentukan.

Sintaks

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

Parameter

hPhone

Tangani ke perangkat telepon terbuka. Aplikasi harus menjadi pemilik telepon.

dwRow

Posisi baris pada tampilan tempat teks baru akan ditampilkan.

dwColumn

Posisi kolom pada tampilan tempat teks baru akan ditampilkan.

lpsDisplay

Arahkan ke lokasi memori tempat konten tampilan disimpan. Informasi tampilan harus memiliki format yang ditentukan dalam anggota dwStringFormat dari struktur PHONECAPS , yang menjelaskan kemampuan perangkat ponsel.

dwSize

Ukuran informasi yang ditujukkan oleh lpsDisplay, dalam byte. Jika parameter lpsDisplay adalah penunjuk ke string, ukurannya harus menyertakan terminator null.

Nilai kembali

Mengembalikan pengidentifikasi permintaan positif jika fungsi selesai secara asinkron atau nomor kesalahan negatif jika terjadi kesalahan. Parameter dwParam2 dari pesan PHONE_REPLY yang sesuai adalah nol jika fungsi berhasil atau merupakan nomor kesalahan negatif jika terjadi kesalahan. Nilai yang mungkin dikembalikan adalah:

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

Keterangan

Informasi tampilan yang ditentukan ditulis ke tampilan telepon, dimulai dari posisi yang ditentukan. Operasi ini menimpa informasi yang ditampilkan sebelumnya. Jika jumlah informasi melebihi ukuran tampilan, informasi akan terpotong. Jumlah informasi yang dapat ditampilkan paling banyak (dwNumRows * dwNumColumns) dalam ukuran. dwNumRows dan dwNumColumns tersedia dalam struktur PHONECAPS , yang dikembalikan oleh phoneGetDevCaps; mereka berbasis nol.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	tapi.h
Pustaka	Tapi32.lib
DLL	Tapi32.dll

Lihat juga

PHONECAPS

PHONE_REPLY

Fungsi Layanan Telepon Tambahan

Gambaran Umum Referensi TAPI 2.2

phoneGetDevCaps