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

Artigo
03/04/2024

Recupera um objeto de configuração de fluxo ASF (Advanced Systems Format) para um fluxo no perfil. Esse método faz referência ao fluxo por número de fluxo em vez de índice de fluxo.

Sintaxe

HRESULT GetStreamByNumber(
  [in]  WORD               wStreamNumber,
  [out] IMFASFStreamConfig **ppIStream
);

Parâmetros

[in] wStreamNumber

O número do fluxo para o qual obter o ponteiro da interface.

[out] ppIStream

Recebe um ponteiro para a interface IMFASFStreamConfig do objeto de configuração de fluxo do ASF. O chamador deve liberar a interface .

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

Comentários

Esse método não cria uma cópia do objeto de configuração de fluxo. O ponteiro recuperado aponta para o objeto dentro do objeto de perfil. Você não deve fazer nenhuma alteração no objeto de configuração de fluxo usando esse ponteiro, pois isso pode afetar o objeto de perfil de maneiras inesperadas.

Para alterar a configuração do objeto de configuração de fluxo no perfil, primeiro você deve clonar o objeto de configuração de fluxo chamando IMFASFStreamConfig::Clone. Faça as alterações necessárias ao clone do objeto e adicione o objeto atualizado chamando o método IMFASFProfile::SetStream .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wmcontainer.h
Biblioteca	Mfuuid.lib