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
S_OK	Êxito.
E_INVALIDARG	Argumento inválido.
VFW_E_DVD_INVALIDDOMAIN	Domínio inválido.
VFW_E_DVD_OPERATION_INHIBITED	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	DVD_DOMAIN_VideoManagerMenu DVD_DOMAIN_VideoTitleSetMenu DVD_DOMAIN_Title DVD_DOMAIN_Stop

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

Confira também

Aplicativos de DVD

Códigos de erro e êxito

IDvdControl2 Interface