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 から始まります。