Share via

ITStreamControl::CreateStream メソッド (tapi3if.h)

  • [アーティクル]

CreateStream メソッドは、新しいメディア ストリームを作成します。

構文

HRESULT CreateStream(
  [in]  long               lMediaType,
  [in]  TERMINAL_DIRECTION td,
  [out] ITStream           **ppStream
);

パラメーター

[in] lMediaType

ストリームの メディアの種類 を示します。

[in] td

TERMINAL_DIRECTIONを示します。

[out] ppStream

新しく作成された ITStream インターフェイスのポインターへのポインター。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

値 説明
S_OK
 メソッドが成功しました。
E_POINTER
 ppStream パラメーターが有効なポインターではありません。
E_OUTOFMEMORY
 操作を実行するためのメモリが不足しています。
TAPI_E_INVALIDMEDIATYPE
 lMediaType パラメーターが有効なメディアの種類ではありません。
TAPI_E_INVALIDDIRECTION
 td パラメーターが有効なターミナル方向ではありません。
TAPI_E_MAXSTREAMS
 サポートされているストリームの最大数に既に達しています。
TAPI_E_NOTSUPPORTED
 この操作はサポートされていません。

解説

多くの MSP は、ストリームの動的な作成をサポートせず、単にこのメソッドの実装でTAPI_E_MAXSTREAMSを返します。 既定のストリームは、呼び出しの作成時に自動的に使用できるため、ほとんどのアプリケーションでこのメソッドを使用する必要はありません。

ストリームの作成または削除には、リモート エンドポイントとの対話が含まれる場合があり、その結果、ストリームが停止または開始されたときに受信されるCMC_LOCAL_REQUEST メッセージではなく、CMC_REMOTE_REQUESTが発生する可能性があります。

TAPI は、ITStreamControl::CreateStream によって返される ITStream インターフェイスで AddRef メソッドを呼び出します。 アプリケーションは、ITStream インターフェイスで Release を呼び出して、それに関連付けられているリソースを解放する必要があります。

必要条件

   
対象プラットフォーム Windows
ヘッダー tapi3if.h (Tapi3.h を含む)

関連項目

ITStreamControl

メディア サービス プロバイダー インターフェイス (MSPI)

TERMINAL_DIRECTION

メディアの種類