Método IDvdControl2::SelectVideoModePreference (strmif.h)
[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]
O SelectVideoModePreference método define a exibição do modo de vídeo especificado (tela larga, caixa de correio ou pan-scan) para reprodução.
Sintaxe
HRESULT SelectVideoModePreference(
[in] ULONG ulPreferredDisplayMode
);
Parâmetros
[in] ulPreferredDisplayMode
Valor que especifica o novo modo de exibição para conteúdo de DVD. Membro da enumeração DVD_PREFERRED_DISPLAY_MODE .
Retornar valor
Retorna um dos valores a seguir.
| Código de retorno | Descrição |
|---|---|
|
Êxito. |
|
Argumento inválido. |
|
Domínio inválido. |
|
O controle UOP proíbe a operação. |
Comentários
Esse método altera a taxa de proporção da janela de vídeo padrão e também pode especificar um mecanismo de conversão de taxa de proporção padrão.
Para vídeo de origem anmórfico de 16 x 9, formado estendendo o vídeo de origem 720 x 480 para uma taxa de proporção de 16 x 9.
Widescreen O vídeo de origem 16 x 9 deve ser colocado e estendido para a maior área 16 x 9 da janela de saída do cliente. Os realces são relativos ao interior da área 16 x 9. As barras pretas devem ser adicionadas à parte superior/inferior ou às laterais para manter uma área de 16 x 9.
Verificação panorâmica O vídeo mostrado é calculado usando uma subwindow 4 x 3 do vídeo estendido de 16 x 9 (o deslocamento horizontal é fornecido no deslocamento da janela do vídeo MPEG-2). A subwindow 4 x 3 é colocada na maior área 4 x 3 da janela do cliente de saída. As coordenadas do realce são relativas à janela de saída 4 x 3 (e não têm relação com o vídeo de origem 16 x 9). As barras pretas devem ser adicionadas à parte superior/inferior ou às laterais para manter uma área 4 x 3.
Letterbox Uma área de exibição 4 x 3 é formada tomando a maior área 4 x 3 da janela do cliente de saída. As barras pretas devem ser adicionadas à parte superior/inferior ou às laterais para manter uma área 4 x 3. O vídeo de origem 16 x 9 é colocado na maior subwindow 16 x 9 dentro da subwindow 4 x 3. Barras pretas devem ser adicionadas à parte superior e inferior da subwindow para manter uma área de 16 x 9. As coordenadas do realce são relativas à subwindow 4 x 3 (e não têm relação com o vídeo de origem 16 x 9). Tecnicamente, é possível que um disco especifique um realce que esteja fora da área 16 x 9 (mas ainda na janela 4 x 3).
Para vídeo 4 x 3, o vídeo é colocado na maior área de saída 4 x 3 da janela do cliente de saída. As barras pretas devem ser adicionadas à parte superior/inferior ou às laterais para manter uma área 4 x 3.
A tabela a seguir mostra o nome do comando Anexo J ao qual esse nome de método corresponde e os domínios nos quais esse método é válido.
| Nome do comando Anexo J | Domínios válidos |
| Video_Presentation_Mode_Change |
|
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | strmif.h (inclua Dshow.h) |
| Biblioteca | Strmiids.lib |