Método IMFPMediaPlayer::SetVideoSourceRect (mfplay.h)

  • Artículo
Importante Obsoleto. Esta API se puede quitar de futuras versiones de Windows. Las aplicaciones deben usar la sesión multimedia para la reproducción.
 

Establece el rectángulo de origen de vídeo.

MFPlay recorta el vídeo a este rectángulo y amplía el rectángulo para rellenar la ventana de vídeo.

Sintaxis

HRESULT SetVideoSourceRect(
  [in] const MFVideoNormalizedRect *pnrcSource
);

Parámetros

[in] pnrcSource

Puntero a una estructura MFVideoNormalizedRect que especifica el rectángulo de origen. Este rectángulo define qué parte del vídeo se muestra. Se especifica en coordenadas normalizadas, que se definen de la siguiente manera:

  • La esquina superior izquierda de la imagen de vídeo es (0, 0).
  • La esquina inferior derecha de la imagen de vídeo es (1, 1).
Para mostrar toda la imagen, establezca el rectángulo de origen en {0, 0, 1, 1}. Este es el valor predeterminado.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
MF_E_INVALIDREQUEST
 El elemento multimedia actual no contiene vídeo.
MF_E_SHUTDOWN
 Se llamó al método Shutdown del objeto.

Comentarios

MFPlay amplía el rectángulo de origen para rellenar toda la ventana de vídeo. De forma predeterminada, MFPlay mantiene la relación de aspecto correcta del origen, letterboxing si es necesario. El color del cuadro de letras se controla mediante el método IMFPMediaPlayer::SetBorderColor .

Este método produce un error si no hay ningún elemento multimedia establecido actualmente o si el elemento multimedia actual no contiene vídeo.

Para establecer la posición del vídeo antes de que se inicie la reproducción, llame a este método dentro del controlador de eventos para el evento MFP_EVENT_TYPE_MEDIAITEM_SET . Para obtener más información, consulta IMFPMediaPlayerCallback::OnMediaPlayerEvent.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mfplay.h

Consulte también

IMFPMediaPlayer

Uso de MFPlay para la reproducción de audio y vídeo