共用方式為

ITMediaCollection：：Create 方法

  • 發行項

[ Rendezvous IP Telephony Conferencing Controls and interface not available for use in Windows Vista， Windows Server 2008， and subsequent versions of the operating system. RTC 用戶端 API 提供類似的功能。]

Create方法會建立具有預設屬性的新媒體、將它新增至集合中指定的索引處，並傳回ITMedia介面的指標。

語法

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

參數

索引 [in]

新專案的索引。 索引的最小值是 1，而索引的最大值是目前的專案數 + 1。

ppMedia [out]

已建立 ITMedia 介面的指標。

傳回值

這個方法可以傳回下列其中一個值。

值 意義
S_OK
 方法成功。
E_POINTER
 ppMedia參數不是有效的指標。
E_INVALIDARG
 Index參數無效。
E_OUTOFMEMORY
 記憶體不足，無法執行作業。
E_FAIL
 未指定的錯誤。
E_NOTIMPL
 尚未實作這個方法。

備註

大部分的 C 和 C++ 清單都是以 0 為基礎，但此索引是以 1 為基礎，用於 Visual Basic 相容性，這表示第一個專案的索引編號為 1。

TAPI 會在ITMediaCollection：：Create所傳回的ITMedia介面上呼叫AddRef方法。 應用程式必須在ITMedia介面上呼叫Release，以釋放與其相關聯的資源。

規格需求

需求 值
TAPI 版本
 需要 TAPI 3.0 或更新版本
標頭
Sdpblb.h
程式庫
Uuid.lib
DLL
Sdpblb.dll

另請參閱

ITMedia

ITMediaCollection