Share via

TSPI_lineDevSpecificFeature関数 (tspi.h)

  • [アーティクル]

TSPI_lineDevSpecificFeature関数は、サービス プロバイダーが他の操作で説明されていない機能へのアクセスを提供できるようにするための拡張メカニズムとして使用されます。 これらの拡張機能の意味はデバイス固有であり、これらの拡張機能を利用するには TAPI またはそのクライアント アプリケーションがそれらを完全に認識する必要があります。

構文

LONG TSPIAPI TSPI_lineDevSpecificFeature(
  DRV_REQUESTID dwRequestID,
  HDRVLINE      hdLine,
  DWORD         dwFeature,
  LPVOID        lpParams,
  DWORD         dwSize
);

パラメーター

dwRequestID

非同期要求の識別子。

hdLine

回線デバイスに対するサービス プロバイダーのハンドル。

dwFeature

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

lpParams

機能に依存するパラメーター ブロックを保持するために使用されるメモリ領域へのポインター。 このパラメーター ブロックの形式は、デバイス固有です。

dwSize

バッファーのサイズ (バイト単位)。 lpParams パラメーターが文字列へのポインターである場合、サイズには null ターミネータを含める必要があります。

戻り値

エラーが発生した場合は 、dwRequestID またはエラー番号を返します。 対応するASYNC_COMPLETIONの lResult 実際のパラメーターは、関数が成功した場合は 0、エラーが発生した場合はエラー番号です。 可能な戻り値は次のとおりです。

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

注釈

追加の戻り値は、デバイス固有です。 hdCall の呼び出し状態はデバイス固有です。

この関数は、TAPI アプリケーションに電話機能ボタン エミュレーション機能を提供します。 TAPI は、クライアント アプリケーションの代わりにこの操作を呼び出すときに、"ボタンを押す" イベントに相当するものを指定します。 この機能の呼び出し方法は、API によってその意味が定義されないため、デバイスに大きく依存します。 アプリケーションがデバイス固有の拡張機能に依存している場合、アプリケーションは他のサービス プロバイダー環境に適切に移植されません。

この関数は、TAPI lineDevSpecificFeature 関数を呼び出すアプリケーションに直接応答して呼び出されます。 TAPI は、TAPI レベルで使用される hLine パラメーターを、TSPI レベルで使用される対応する hdLine パラメーターに変換します。 lpParams バッファーは、変更されていない状態で渡されます。

メモlpParams データ構造には、32 ビット バージョンの TAPI で 16 ビット アプリケーションを実行するときに適切に変換 (サンク処理) されないため、ポインターを含めないようにする必要があります。その逆も同様です。
 
この操作は、拡張テレフォニー サービスの一部です。 意味を定義せずに、デバイス固有の機能へのアクセスのみを提供します。 この操作は、TAPI が正常にネゴシエートされ、デバイス固有の拡張機能バージョンを選択した場合にのみ使用できます。

要件

要件 値
対象プラットフォーム Windows
ヘッダー tspi.h

こちらもご覧ください

ASYNC_COMPLETION

LINE_DEVSPECIFICFEATURE

PHONEBUTTONFUNCTION_定数