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 インターフェイスへのポインター。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
値 | 説明 |
---|---|
|
メソッドが成功しました。 |
|
ppMedia パラメーターが有効なポインターではありません。 |
|
Index パラメーターが無効です。 |
|
操作を実行するためのメモリが不足しています。 |
|
未定義のエラーが発生しました。 |
|
このメソッドはまだ実装されていません。 |
解説
ほとんどの C および C++ リストは 0 から始まりますが、このインデックスは Visual Basic との互換性のために 1 から始まります。つまり、最初の項目のインデックス番号は 1 です。
TAPI は、ITMediaCollection::Create によって返される ITMedia インターフェイスで AddRef メソッドを呼び出します。 アプリケーションは、ITMedia インターフェイスで Release を呼び出して、それに関連付けられているリソースを解放する必要があります。
要件
要件 | 値 |
---|---|
TAPI バージョン |
TAPI 3.0 以降が必要です |
ヘッダー |
|
ライブラリ |
|
[DLL] |
|