TSPI_lineSetMediaMode関数 (tspi.h)

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

TSPI_lineSetMediaMode関数は、呼び出しの LINECALLINFO 構造体に格納されている呼び出しのメディアを変更します。

構文

LONG TSPIAPI TSPI_lineSetMediaMode(
  HDRVCALL hdCall,
  DWORD    dwMediaMode
);

パラメーター

hdCall

メディアの種類が変更される呼び出しのハンドル。 hdCall の呼び出し状態は任意の状態にすることができます。

dwMediaMode

呼び出しの新しいメディアの種類。 LINEMEDIAMODE_UNKNOWNメディアタイプフラグが設定されている限り、他の複数のメディアタイプフラグも設定できます。これは、呼び出しのメディアタイプを完全には決定されていないものとして識別するために使用されますが、指定されたメディアタイプの小さなセットのいずれかに絞り込まれます。 LINEMEDIAMODE_UNKNOWN フラグが設定されていない場合は、1 つのメディア・タイプのみを指定できます。このパラメーターは、 LINEMEDIAMODE_定数の 1 つ以上を使用します。

戻り値

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

LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALMEDIAMODE、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_RESOURCEUNAVAIL。

注釈

呼び出しの LINECALLINFO 構造体に格納されている呼び出しのメディアを変更する以外に、このプロシージャは、呼び出しに特定の変更を強制するのではなく、発生しようとしている予想されるメディアの変更を示すという意味で単にアドバイザリです。一般的な使用方法は、呼び出しのメディアの種類を特定の既知のメディアの種類に設定するか、呼び出しのメディアの種類が完全にわかっていない限り (UNKNOWN メディアの種類フラグが設定されている) 限り、可能なメディアの種類を除外することです。

TAPI は、渡されたメディアの種類に関して次の保証を行います。(1) 少なくとも 1 つのビットセットがあり、(2) 予約済みビットが設定されておらず、(3) 複数のビットが設定されている場合は "Unknown" も設定されます。サービスプロバイダーは、メディアの種類に対してそれ以上の有効性チェックを実行する必要があります。たとえば、メディアの種類が実際にサービスプロバイダーによってサポートされているかどうかを確認する必要があります。