Compartir a través de


ITMediaCollection::Create (método)

[ Los controles e interfaces de conferencia de telefonía IP de Rendezvous no están disponibles para su uso en Windows Vista, Windows Server 2008 y versiones posteriores del sistema operativo. La API de cliente RTC proporciona una funcionalidad similar.]

El método Create crea un nuevo medio con propiedades predeterminadas, lo agrega a la colección en el índice especificado y devuelve un puntero a la interfaz ITMedia .

Sintaxis

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

Parámetros

Índice [in]

Índice del nuevo elemento. El valor mínimo del índice es 1 y el valor máximo del índice es el número actual de elementos + 1.

ppMedia [out]

Puntero a la interfaz ITMedia creada.

Valor devuelto

Este método puede devolver uno de estos valores.

Value Significado
S_OK
El método se realizó correctamente.
E_POINTER
El parámetro ppMedia no es un puntero válido.
E_INVALIDARG
El parámetro Index no es válido.
E_OUTOFMEMORY
Existe memoria insuficiente para realizar la operación.
E_FAIL
Error no especificado.
E_NOTIMPL
Este método aún no se ha implementado.

Comentarios

La mayoría de las listas de C y C++ se basan en 0, pero este índice se basa en 1 para la compatibilidad de Visual Basic, lo que significa que el primer elemento tiene un número de índice de 1.

TAPI llama al método AddRef en la interfaz ITMedia devuelta por ITMediaCollection::Create. La aplicación debe llamar a Release en la interfaz de ITMedia para liberar recursos asociados a él.

Requisitos

Requisito Value
Versión de TAPI
Requiere TAPI 3.0 o posterior
Encabezado
Sdpblb.h
Biblioteca
Uuid.lib
Archivo DLL
Sdpblb.dll

Consulte también

ITMedia

ITMediaCollection