ITMediaCollection::Create メソッド

  • [アーティクル]

[ ランデブー IP テレフォニー会議のコントロールとインターフェイスは、Windows Vista、Windows Server 2008、および以降のバージョンのオペレーティング システムでは使用できません。 RTC クライアント API も同様の機能を提供します。

Create メソッドは、既定のプロパティを持つ新しいメディアを作成し、それを指定したインデックス位置のコレクションに追加し、ITMedia インターフェイスへのポインターを返します。

構文

HRESULT Create(
  [in]  LONG    Index,
  [out] ITMedia **ppMedia
);

パラメーター

Index [in]

新しい項目のインデックス。 インデックスの最小値は 1 で、インデックスの最大値は現在のアイテム数 + 1 です。

ppMedia [out]

作成された ITMedia インターフェイスへのポインター。

戻り値

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

値 説明
S_OK
 メソッドが成功しました。
E_POINTER
 ppMedia パラメーターが有効なポインターではありません。
E_INVALIDARG
 Index パラメーターが無効です。
E_OUTOFMEMORY
 操作を実行するためのメモリが不足しています。
E_FAIL
 未定義のエラーが発生しました。
E_NOTIMPL
 このメソッドはまだ実装されていません。

解説

ほとんどの C および C++ リストは 0 から始まりますが、このインデックスは Visual Basic との互換性のために 1 から始まります。つまり、最初の項目のインデックス番号は 1 です。

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

要件

要件 値
TAPI バージョン
 TAPI 3.0 以降が必要です
ヘッダー
Sdpblb.h
ライブラリ
Uuid.lib
[DLL]
Sdpblb.dll

関連項目

ITMedia

ITMediaCollection