lineDevSpecificFeature 関数 (tapi.h)

[アーティクル]
03/02/2024

lineDevSpecificFeature 関数を使用すると、サービスプロバイダーは他の TAPI 関数によって提供されない機能にアクセスできます。これらの拡張機能の意味はデバイス固有のものであり、これらの拡張機能を利用するには、アプリケーションがそれらを完全に認識する必要があります。

構文

LONG lineDevSpecificFeature(
  HLINE  hLine,
  DWORD  dwFeature,
  LPVOID lpParams,
  DWORD  dwSize
);

パラメーター

hLine

ラインデバイスへのハンドル。

dwFeature

ラインデバイスで呼び出す機能。このパラメーターは、PHONEBUTTONFUNCTION_定数を使用します。

lpParams

機能に依存するパラメーターブロックを保持するために使用されるメモリ領域へのポインター。このパラメーターブロックの形式はデバイス固有であり、その内容は TAPI によってサービスプロバイダーとの間で渡されます。

dwSize

バッファーのサイズ (バイト単位)。

戻り値

関数が非同期的に完了した場合は正の要求識別子を返し、エラーが発生した場合は負のエラー番号を返します。関数が成功した場合は、対応するLINE_REPLY メッセージの dwParam2 パラメーターは 0、エラーが発生した場合は負のエラー番号です。可能な戻り値は次のとおりです。

LINEERR_INVALFEATURE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALLINEHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALPOINTER、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_UNINITIALIZED。

追加の戻り値はデバイス固有です。

注釈

この操作は、拡張テレフォニーサービスの一部です。意味を定義せずに、デバイス固有の機能へのアクセスを提供します。この操作は、アプリケーションがデバイス固有の拡張機能バージョンを正常にネゴシエートした場合にのみ使用できます。

この関数は、電話機能ボタンエミュレーション機能をアプリケーションに提供します。アプリケーションは、この操作を呼び出すときに、ボタン押しイベントと同等のイベントを指定します。 TAPI では意味が定義されないため、この機能の呼び出し方法はデバイスに依存します。通常、これらのデバイス固有の拡張機能に依存するアプリケーションは、他のサービスプロバイダー環境では動作しません。

lpParams が指す構造体には、32 ビットバージョンの TAPI で 16 ビットアプリケーションを実行するときに適切に変換 (サンク処理) されないため、ポインターを含めないようにする必要があります。その逆も同様です。