Método IVMRFilterConfig::SetNumberOfStreams (strmif.h)

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O SetNumberOfStreams método define o número de fluxos a serem mistos e instrui a VMR a entrar no modo de mixer.

Sintaxe

HRESULT SetNumberOfStreams(
  [in] DWORD dwMaxStreams
);

Parâmetros

[in] dwMaxStreams

Palavra dupla que contém o número máximo de fluxos de entrada que a VMR será necessária para misturar. Não deve ser maior que MAX_MIXER_STREAMS (16).

Retornar valor

Se o método for bem-sucedido, retornará S_OK. Se falhar, retornará um código de erro.

Comentários

dwMaxStreams deve ser igual ao número de pinos de entrada necessários. Os pinos não podem ser adicionados ou removidos após a conexão da VMR. Se você não souber com antecedência quantos fluxos de entrada serão necessários, defina dxMaxStreams como o número máximo que pode ser necessário. Um valor de 1 é válido para dwMaxStreams. Esse valor não faz com que nenhum pino extra seja criado, mas força a VMR a entrar no "modo de mixer". Portanto, depois que esse método for chamado, você não poderá chamar SetRenderingMode para definir o modo como VMRMode_Renderless

A VMR cria quantos pinos de entrada forem especificados sem tentar determinar se há memória de vídeo suficiente para dar suporte a todos eles. Isso ocorre porque ele não tem como conhecer o tipo de mídia ou as dimensões do retângulo no momento. Posteriormente, quando um filtro de upstream tenta se conectar a um pino, nesse ponto o tipo de mídia é conhecido e a VMR examinará a memória do vídeo e falhará na conexão se não houver o suficiente para processar o fluxo.

Requisitos

Confira também

Códigos de erro e êxito

IVMRFilterConfig Interface

IVMRFilterConfig::GetNumberOfStreams

Usando o Renderizador de Combinação de Vídeo