Поделиться через

Метод ITMediaCollection::Create

  • Статья

[ Элементы управления и интерфейсы конференц-связи с IP-телефонией для встреч недоступны для использования в Windows Vista, Windows Server 2008 и последующих версиях операционной системы. Api клиента RTC предоставляет аналогичные функции.]

Метод 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 вызывает метод AddRef в интерфейсе ITMedia, возвращенном ITMediaCollection::Create. Приложение должно вызывать Release в интерфейсе ITMedia , чтобы освободить связанные с ним ресурсы.

Требования

Требование Значение
Версия TAPI
 Требуется TAPI 3.0 или более поздней версии
Заголовок
Sdpblb.h
Библиотека
Uuid.lib
DLL
Sdpblb.dll

См. также раздел

ITMedia

ITMediaCollection