Método CBaseControlVideo.GetDestinationPosition

Artículo
07/28/2023

[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 GetDestinationPosition método recupera el rectángulo de destino en una operación atómica.

Sintaxis

HRESULT GetDestinationPosition(
   long *pLeft,
   long *pTop,
   long *pWidth,
   long *pHeight
);

Parámetros

pLeft: Puntero a la coordenada izquierda del rectángulo de destino.
pTop: Puntero a la coordenada superior del rectángulo de destino.
pWidth: Puntero al ancho del rectángulo de destino.
pHeight: Puntero al alto del rectángulo de destino.

Valor devuelto

Devuelve un valor HRESULT que depende de la implementación; puede ser uno de los siguientes valores u otros valores no enumerados.

Código devuelto	Descripción
E_FAIL	Error.
E_POINTER	Argumento de puntero NULL.
VFW_E_NOT_CONNECTED	No se puede realizar la operación porque las patillas no están conectadas.
NOERROR	Correcto.

Observaciones

Esta función miembro se puede usar en lugar de llamadas independientes a las funciones miembro CBaseControlVideo::get_DestinationLeft, CBaseControlVideo::get_DestinationTop, CBaseControlVideo::get_DestinationWidth y CBaseControlVideo::get_DestinationHeight miembro. Una aplicación puede cambiar los rectángulos de origen y destino del vídeo a través de la interfaz IBasicVideo . El rectángulo de origen afecta a qué sección del origen de vídeo nativo aparecerá en la pantalla; el rectángulo de destino afecta a dónde aparecerá el vídeo cuando se reproduzca. El rectángulo de destino es relativo al área cliente de la ventana en la que se está reproduciendo. La esquina superior izquierda de la ventana es coordenada (0,0).

Requisitos

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

Consulte también

CBaseControlVideo (clase)