Método IDvdControl2::SelectVideoModePreference (strmif.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 SelectVideoModePreference método establece la pantalla del modo de vídeo especificada (pantalla ancha, cuadro de letras o examen panorámico) para la reproducción.

Sintaxis

HRESULT SelectVideoModePreference(
  [in] ULONG ulPreferredDisplayMode
);

Parámetros

[in] ulPreferredDisplayMode

Valor que especifica el nuevo modo de visualización para el contenido de DVD. Miembro de la enumeración DVD_PREFERRED_DISPLAY_MODE .

Valor devuelto

Devuelve uno de los valores siguientes.

Código devuelto	Descripción
S_OK	Correcto.
E_INVALIDARG	Argumento no válido.
VFW_E_DVD_INVALIDDOMAIN	dominio no válido.
VFW_E_DVD_OPERATION_INHIBITED	El control UOP prohíbe la operación.

Comentarios

Este método cambia la relación de aspecto de la ventana de vídeo predeterminada y también puede especificar un mecanismo de conversión de relación de aspecto predeterminado.

Para el vídeo de origen anamórfico 16 x 9, formado por extender el vídeo de origen de 720 x 480 a una relación de aspecto de 16 x 9.

Pantalla ancha El vídeo de origen de 16 x 9 debe colocarse y extenderse en el área de 16 x 9 más grande de la ventana de salida del cliente. Los resaltados son relativos al interior del área de 16 x 9. Las barras negras deben agregarse a la parte superior/inferior o a los lados para mantener un área de 16 x 9.

Examen panorámico El vídeo que se muestra se calcula tomando una subventana de 4 x 3 del vídeo extendido de 16 x 9 (el desplazamiento horizontal se proporciona en el desplazamiento de la ventana del vídeo MPEG-2). La subventana de 4 x 3 se coloca en el área de 4 x 3 más grande de la ventana del cliente de salida. Las coordenadas del resaltado son relativas a la ventana de salida 4 x 3 (y no tienen ninguna relación con el vídeo de origen 16 x 9). Las barras negras deben agregarse a la parte superior/inferior o a los lados para mantener un área de 4 x 3.

Buzón Un área de visualización de 4 x 3 se forma tomando el área de 4 x 3 más grande de la ventana del cliente de salida. Las barras negras deben agregarse a la parte superior/inferior o a los lados para mantener un área de 4 x 3. El vídeo de origen 16 x 9 se coloca en el subwindow de 16 x 9 más grande dentro de la subventana 4 x 3. Se deben agregar barras negras a la parte superior e inferior de la subventana para mantener un área de 16 x 9. Las coordenadas del resaltado son relativas a la subventana de 4 x 3 (y no tienen ninguna relación con el vídeo de origen 16 x 9). Técnicamente es posible que un disco especifique un resaltado que se encuentra fuera del área 16 x 9 (pero todavía en la ventana 4 x 3).

Para 4 x 3 vídeo, el vídeo se coloca en el área de salida de 4 x 3 más grande de la ventana del cliente de salida. Las barras negras deben agregarse a la parte superior/inferior o a los lados para mantener un área de 4 x 3.

En la tabla siguiente se muestra el nombre del comando Anexo J al que corresponde este nombre de método y los dominios en los que este método es válido.

Nombre de comando de Anexo J	Dominios válidos
Video_Presentation_Mode_Change	DVD_DOMAIN_VideoManagerMenu DVD_DOMAIN_VideoTitleSetMenu DVD_DOMAIN_Title DVD_DOMAIN_Stop

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	strmif.h (incluya Dshow.h)
Library	Strmiids.lib

Consulte también

Aplicaciones de DVD

Códigos de error y éxito

Interfaz IDvdControl2