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

Artigo
03/04/2024

Recupera um fluxo do perfil por índice de fluxo e/ou recupera o número de fluxo de um índice de fluxo.

Sintaxe

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

Parâmetros

[in] dwStreamIndex

O índice do fluxo a ser recuperado. Stream índices são sequenciais e baseados em zero. Você pode obter o número de fluxos que estão no perfil chamando o método IMFASFProfile::GetStreamCount .

[out] pwStreamNumber

Recebe o número de fluxo do fluxo solicitado. Stream números são baseados em um e não são necessariamente sequenciais. Esse parâmetro poderá ser definido como NULL se o número do fluxo não for necessário.

[out] ppIStream

Recebe um ponteiro para a interface IMFASFStreamConfig do objeto de configuração de fluxo do ASF. O chamador deve liberar a interface. Esse parâmetro poderá ser NULL se você quiser recuperar o número do fluxo sem acessar a configuração do fluxo.

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