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