Método IVideoWindow::GetMaxIdealImageSize (control.h)

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El GetMaxIdealImageSize método recupera el tamaño de imagen ideal máximo para la imagen de vídeo.

Sintaxis

HRESULT GetMaxIdealImageSize(
  [out] long *pWidth,
  [out] long *pHeight
);

Parámetros

[out] pWidth

Recibe el ancho ideal máximo, en píxeles.

[out] pHeight

Recibe el alto ideal máximo, en píxeles.

Valor devuelto

Entre los posibles valores devueltos se incluyen los siguientes:

Código devuelto	Descripción
E_POINTER	Puntero NULL.
S_FALSE	No se pudo recuperar un tamaño máximo de imagen.
S_OK	Correcto.
VFW_E_WRONG_STATE	El filtro se detiene.

Comentarios

El tamaño ideal máximo puede diferir del tamaño de vídeo nativo, ya que el hardware de vídeo puede tener requisitos de ampliación específicos.

Este método devuelve S_FALSE en varias circunstancias:

• El filtro usa un transporte IOverlay .
• UseWhenFullScreen modo activado. (Vea IDirectDrawVideo::UseWhenFullScreen).
• La superficie de vídeo no tiene ninguna extensión de superposición máxima. (El miembro dwMaxOverlayStretch de la estructura DDCAPS es cero. Vea IDirectDrawVideo::GetCaps).

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	control.h (incluir Dshow.h)
Library	Strmiids.lib

Consulte también

Códigos de error y éxito

IVideoWindow (Interfaz)

IVideoWindow::GetMinIdealImageSize