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 の場合、何もコピーされません。 各データ領域のサイズは、電話のデバイス機能に一覧表示されます。

要件

要件	値
対象プラットフォーム	Windows
ヘッダー	tapi.h
Library	Tapi32.lib
[DLL]	Tapi32.dll

こちらもご覧ください

補助電話サービス機能

TAPI 2.2 リファレンスの概要