Método CBaseControlWindow.GetMaxIdealImageSize

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in 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 Audio/Video Capture in 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 GetMaxIdealImageSize método recupera o tamanho máximo da imagem ideal.

Sintaxe

HRESULT GetMaxIdealImageSize(
   long *pWidth,
   long *pHeight
);

Parâmetros

Pwidth

Ponteiro para a largura ideal máxima, em pixels.

pHeight

Ponteiro para a altura máxima ideal, em pixels.

Retornar valor

Retorna um valor HRESULT .

Comentários

Vários renderizadores têm restrições de desempenho sobre o tamanho das imagens que podem ser exibidas. Embora eles ainda devam funcionar corretamente quando solicitados a exibir imagens maiores que o máximo especificado, os renderizadores podem nomear os tamanhos ideais mínimos e máximos por meio da interface IVideoWindow . Essa interface só pode ser chamada quando o grafo de filtro está em pausa ou em execução, porque não é até lá que os recursos são alocados e o renderizador pode reconhecer suas restrições. Se não houver restrições, o renderizador preencherá os parâmetros pWidth e pHeight com as dimensões de vídeo nativas e retornará S_FALSE. Se houver restrições, a largura e a altura restritas serão inseridas e a função membro retornará S_OK.

As dimensões se aplicam ao tamanho do vídeo de destino e não ao tamanho geral da janela. Portanto, ao calcular o tamanho da janela a ser definida, contabilize os estilos de janela atuais (por exemplo, WS_CAPTION e WS_BORDER).

Requisitos

Requisito Valor
parâmetro
Ctlutil.h (inclua Streams.h)
Biblioteca
Strmbase.lib (builds de varejo);
Strmbasd.lib (builds de depuração)

Confira também

Classe CBaseControlWindow