TSPI_lineSetDefaultMediaDetection関数 (tspi.h)

[アーティクル]
08/26/2023

TSPI_lineSetDefaultMediaDetectionプロシージャは、指定された行を検出する新しいメディアの種類のセットをサービスプロバイダーに指示します (前のセットを置き換えます)。また、この行の後続の呼び出し (受信または送信) で監視する必要があるメディアの種類の初期セットも設定します。

構文

LONG TSPIAPI TSPI_lineSetDefaultMediaDetection(
  HDRVLINE hdLine,
  DWORD    dwMediaModes
);

パラメーター

hdLine

メディア監視を設定する行のハンドル。

dwMediaModes

TAPI に関心のあるメディアの種類。このパラメーターは、 LINEMEDIAMODE_定数のいずれかを使用します。

戻り値

関数が成功した場合は 0 を返し、エラーが発生した場合はエラー番号を返します。可能な戻り値は次のとおりです。

LINEERR_INVALLINEHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALMEDIAMODE、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_NODRIVER、LINEERR_OPERATIONUNAVAIL。

注釈

TAPI は通常、この関数を呼び出して、TAPI レベルで行が開かれているか閉じられたときに、すべての未処理の行で選択されたすべてのモードの和集合に対して、検出されたメディアの種類のセットを更新します。メディア検出が拒否された場合、 lineOpen 呼び出しの試行は拒否されます。通常、このプロシージャの 1 回の呼び出しは、デバイス識別子 LINEMAPPER を指定しない lineOpen 呼び出しの結果です。デバイス識別子 LINEMAPPER は TSPI レベルでは使用されません。

TAPI は、すべてのクライアントが必要とするメディアの種類の和集合を計算し、結果をこの関数に渡す必要があります。サービスプロバイダーは、TAPI によってこの関数に渡されたセットを使用します。 TAPI は、 dwMediaModes パラメーターに少なくとも 1 つのビットセットがあり、予約済みビットが設定されていないことを確認します。サービスプロバイダーは、メディアの種類に対してそれ以上の有効性チェックを実行する必要があります。たとえば、メディアの種類が実際にサービスプロバイダーによってサポートされているかどうかを確認する必要があります。回線が開いているアプリケーションがすべてモニターであるか、着信呼び出しの処理に関心がない場合、すべてのメディア・タイプの共用体は値 0 になります。

TAPI レベルに直接対応する関数はありません。このプロシージャは、 lineOpen プロシージャが特定のデバイス識別子 (LINEMAPPER 以外) で呼び出されたときに、特定の行に対して暗黙的に指定された "要求メディアの種類" に対応します。