Método IMFSourceReader::SetStreamSelection (mfreadwrite.h)

Seleciona ou desmarca um ou mais fluxos.

Sintaxe

HRESULT SetStreamSelection(
  [in] DWORD dwStreamIndex,
  [in] BOOL  fSelected
);

Parâmetros

[in] dwStreamIndex

O fluxo a ser definido. O valor pode ser qualquer um dos seguintes.

[in] fSelected

Especifique TRUE para selecionar fluxos ou FALSE para desmarcar fluxos. Se um fluxo for desmarcado, ele não gerará dados.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Há dois usos comuns para este método:

• Para alterar a seleção de fluxo padrão. Alguns arquivos de mídia contêm vários fluxos do mesmo tipo. Por exemplo, um arquivo pode incluir fluxos de áudio para vários idiomas. Você pode usar esse método para alterar qual dos fluxos está selecionado. Para obter informações sobre cada fluxo, chame IMFSourceReader::GetPresentationAttribute ou IMFSourceReader::GetNativeMediaType.
• Se você não precisar de dados de um dos fluxos, é uma boa ideia desmarcar esse fluxo. Se o fluxo estiver selecionado, a fonte de mídia poderá manter uma fila de dados não lidos e a fila poderá crescer indefinidamente, consumindo memória.

Se um fluxo for desmarcado, o método IMFSourceReader::ReadSample retornará MF_E_INVALIDREQUEST para esse fluxo. Outros métodos IMFSourceReader são válidos para fluxos desmarcados.

Stream seleção não afeta como o leitor de origem carrega ou descarrega decodificadores na memória. Em particular, desmarcar um fluxo não força o leitor de origem a descarregar o decodificador para esse fluxo.

Essa interface estará disponível no Windows Vista se o Suplemento de Atualização de Plataforma para Windows Vista estiver instalado.

Requisitos

Confira também

IMFSourceReader

Leitor de origem