Método IVideoWindow::GetMaxIdealImageSize (control.h)
[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 para a imagem de vídeo.
Sintaxe
HRESULT GetMaxIdealImageSize(
[out] long *pWidth,
[out] long *pHeight
);
Parâmetros
[out] pWidth
Recebe a largura ideal máxima, em pixels.
[out] pHeight
Recebe a altura ideal máxima, em pixels.
Retornar valor
Os possíveis valores retornados incluem o seguinte:
| Código de retorno | Descrição |
|---|---|
|
Ponteiro NULL . |
|
Não foi possível recuperar um tamanho máximo de imagem. |
|
Êxito. |
|
O filtro foi interrompido. |
Comentários
O tamanho ideal máximo pode ser diferente do tamanho do vídeo nativo, pois o hardware de vídeo pode ter requisitos de alongamento específicos.
Esse método retorna S_FALSE em várias circunstâncias:
- O filtro está usando um transporte IOverlay .
- Use O modo UseWhenFullScreen está ativado. (Consulte IDirectDrawVideo::UseWhenFullScreen.)
- A superfície de vídeo não tem um alongamento máximo de sobreposição. (O membro dwMaxOverlayStretch da estrutura DDCAPS é zero. Consulte IDirectDrawVideo::GetCaps.)
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | control.h (inclua Dshow.h) |
| Biblioteca | Strmiids.lib |