enumeración DVD_PREFERRED_DISPLAY_MODE (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.
Sintaxis
typedef enum tagDVD_PREFERRED_DISPLAY_MODE {
DISPLAY_CONTENT_DEFAULT = 0,
DISPLAY_16x9 = 1,
DISPLAY_4x3_PANSCAN_PREFERRED = 2,
DISPLAY_4x3_LETTERBOX_PREFERRED = 3
} DVD_PREFERRED_DISPLAY_MODE;
Constantes
DISPLAY_CONTENT_DEFAULTValor: 0 Use el tamaño de ventana predeterminado y el tipo de contenido. |
DISPLAY_16x9Valor: 1 Use una ventana de 16 x 9. |
DISPLAY_4x3_PANSCAN_PREFERREDValor: 2 Use una ventana de 4 x 3 y convierta en examen panorámico, si es posible. |
DISPLAY_4x3_LETTERBOX_PREFERREDValor: 3 Use una ventana de 4 x 3 y convierta en cuadro de letras, si es posible. |
Observaciones
La enumeración DVD_PREFERRED_DISPLAY_MODE indica la relación de aspecto de ventana preferida del usuario y el método preferido de conversión de contenido de 16 x 9 a una relación de aspecto de ventana de 4 x 3. Examen panorámico y cuadro de cartas son los dos métodos de conversión. Mostrar un vídeo en el tamaño más grande posible dentro de la ventana de visualización sin recortes o estiraciones se llama mostrar en formato de cuadro de letras. El examen panorámico está recortando específicamente un vídeo de 16 x 9 para su visualización en una ventana de 4 x 3 con parámetros definidos por el autor del vídeo.
Este tipo enumerado indica una preferencia de mecanismos de conversión porque algunos contenidos solo se pueden mostrar mediante uno de estos métodos. El contenido que es 4 x 3 siempre se convierte en una ventana de 16 x 9 mediante la conversión sideboxing, donde las barras negras se agregan a los lados derecho e izquierdo de la pantalla en lugar de la parte superior e inferior de la pantalla como en la conversión de 16 x 9 a 4 x 3 mediante la conversión letterboxing.
En la tabla siguiente se muestra el método de conversión utilizado entre el tipo de contenido real que aparece en la primera columna y la configuración de preferencias de visualización del usuario, indicada por una de las otras columnas.
| Tipo de contenido real | 16 x 9 | 4 x 3 recorrido panorámico | Cuadro de letras 4 x 3 |
|---|---|---|---|
| 4 x 3 | Sideboxing | None | None |
| Solo 16 x 9 letras | Ninguno | Buzón | Buzón |
| Solo examen panorámico de 16 x 9 | Ninguno | Examen panorámico | Examen panorámico |
| 16 x 9 examen panorámico o cuadro de letras | Ninguno | Examen panorámico | Buzón |
El tamaño de ventana nativo usado siempre es el tamaño preferido del usuario.
Requisitos
| Encabezado | strmif.h (incluya Dshow.h) |