Método CBaseControlWindow.GetMaxIdealImageSize

  • Artículo

[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.

Sintaxis

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

Parámetros

pWidth

Puntero al ancho ideal máximo, en píxeles.

pHeight

Puntero al alto ideal máximo, en píxeles.

Valor devuelto

Devuelve un valor HRESULT .

Observaciones

Varios representadores tienen restricciones de rendimiento sobre el tamaño de las imágenes que pueden mostrar. Aunque deben seguir funcionando correctamente cuando se solicita mostrar imágenes mayores que el máximo especificado, los representadores pueden designar los tamaños ideales mínimos y máximos a través de la interfaz IVideoWindow . Solo se puede llamar a esta interfaz cuando el grafo de filtro está en pausa o en ejecución, ya que no es hasta entonces que se asignan recursos y el representador puede reconocer sus restricciones. Si no existen restricciones, el representador rellena los parámetros pWidth y pHeight con las dimensiones de vídeo nativas y devuelve S_FALSE. Si existen restricciones, se especifican el ancho restringido y el alto, y la función miembro devuelve S_OK.

Las dimensiones se aplican al tamaño del vídeo de destino y no al tamaño total de la ventana. Por lo tanto, al calcular el tamaño de la ventana que se va a establecer, tenga en cuenta los estilos de ventana actuales (por ejemplo, WS_CAPTION y WS_BORDER).

Requisitos

Requisito Value
Encabezado
Ctlutil.h (include Streams.h)
Biblioteca
Strmbase.lib (compilaciones comerciales);
Strmbasd.lib (compilaciones de depuración)

Consulte también

CBaseControlWindow (clase)