Método IMFASFProfile::GetStream (wmcontainer.h)

Artículo
03/04/2024

Recupera una secuencia del perfil por índice de flujo y/o recupera el número de secuencia de un índice de secuencia.

Sintaxis

HRESULT GetStream(
  [in]  DWORD              dwStreamIndex,
  [out] WORD               *pwStreamNumber,
  [out] IMFASFStreamConfig **ppIStream
);

Parámetros

[in] dwStreamIndex

Índice de la secuencia que se va a recuperar. Stream índices son secuenciales y basados en cero. Puede obtener el número de secuencias que están en el perfil llamando al método IMFASFProfile::GetStreamCount .

[out] pwStreamNumber

Recibe el número de secuencia de la secuencia solicitada. Stream números son basados en uno y no son necesariamente secuenciales. Este parámetro se puede establecer en NULL si no se requiere el número de secuencia.

[out] ppIStream

Recibe un puntero a la interfaz IMFASFStreamConfig del objeto de configuración de flujo asf. El autor de la llamada debe liberar la interfaz . Este parámetro puede ser NULL si desea recuperar el número de secuencia sin tener acceso a la configuración del flujo.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.

Comentarios

Este método no crea una copia del objeto de configuración de secuencia. El puntero que se recupera apunta al objeto dentro del objeto de perfil. No debe realizar ningún cambio en el objeto de configuración de secuencia mediante este puntero, ya que hacerlo puede afectar al objeto de perfil de maneras inesperadas.

Para cambiar la configuración del objeto de configuración de flujo en el perfil, primero debe clonar el objeto de configuración de secuencia llamando a IMFASFStreamConfig::Clone. Realice los cambios necesarios para el clon del objeto y agregue el objeto actualizado llamando al método IMFASFProfile::SetStream .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wmcontainer.h
Library	Mfuuid.lib