TSPI_lineDevSpecific関数 (tspi.h)

  • [アーティクル]

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

構文

LONG TSPIAPI TSPI_lineDevSpecific(
  DRV_REQUESTID dwRequestID,
  HDRVLINE      hdLine,
  DWORD         dwAddressID,
  HDRVCALL      hdCall,
  LPVOID        lpParams,
  DWORD         dwSize
);

パラメーター

dwRequestID

非同期要求の識別子。

hdLine

操作する行に対するサービス プロバイダーのハンドル。

dwAddressID

操作対象の指定された行のアドレス。 アドレス識別子は、アドレスに永続的に関連付けられます。識別子はオペレーティング システムのアップグレード全体で一定のままです。

hdCall

操作する呼び出しに対するサービス プロバイダーのハンドル。 このフィールドの値は NULL である可能性があります。 hdCall の呼び出し状態はデバイス固有です。

lpParams

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

dwSize

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

戻り値

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

LINEERR_INVALLINEHANDLE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALADDRESSID、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_RESOURCEUNAVAIL。

注釈

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

この操作では、ジェネリック パラメーター プロファイルが提供されます。 パラメーター構造の解釈は、デバイス固有です。 TAPI は常に hdLine パラメーターを指定します。 dwAddressID と hdCall のどちらを有効と想定するかは、デバイス固有です。 指定する場合は、 hdLine に属している必要があります。 デバイス固有のアプリケーションに返送された表示と応答では、 LINE_DEVSPECIFIC メッセージが使用されます。

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

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

要件

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

こちらもご覧ください

ASYNC_COMPLETION

LINE_DEVSPECIFIC

TSPI_lineNegotiateExtVersion