Método IDvdControl2::SetSubpictureState (strmif.h)

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na 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 Captura de Áudio/Vídeo no 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 SetSubpictureState método ativa ou desativa a exibição de subpictura.

Sintaxe

HRESULT SetSubpictureState(
  [in]  BOOL    bState,
  [in]  DWORD   dwFlags,
  [out] IDvdCmd **ppCmd
);

Parâmetros

[in] bState

Valor booliano que especifica se a exibição de subpictura está ativada; TRUE define a exibição de subpictura em para reprodução subsequente.

[in] dwFlags

OR bit a bit de um ou mais sinalizadores da enumeração DVD_CMD_FLAGS , especificando como sincronizar o comando.

[out] ppCmd

Recebe um ponteiro para um objeto IDvdCmd que pode ser usado para sincronizar comandos de DVD. O chamador deve liberar a interface. Este parâmetro pode ser NULL. Para obter mais informações, consulte Sincronizando comandos de DVD.

Retornar valor

Retorna um dos valores a seguir.

Código de retorno	Descrição
S_OK	Êxito.
VFW_E_DVD_INVALIDDOMAIN	O Navegador de DVD está no domínio First Play.
VFW_E_DVD_OPERATION_INHIBITED	O controle UOP proíbe a operação.

Comentários

Os fluxos de subpictura normalmente são usados em menus para texto de botão e, às vezes, gráficos de botão, e na reprodução de vídeo para legendas, créditos ou outros gráficos sobrepostos. Não confunda subpicturas com legendas fechadas; os últimos são codificados dentro do fluxo de vídeo. Em geral, esse método destina-se a controlar a exibição de subpictura em vídeo enquanto o filtro DVD Navigator está reproduzindo vídeo no domínio título do DVD.

Esse método corresponde ao segundo parâmetro do comando "Sub-picture_Stream_Change" do Anexo J.

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 Do Anexo J	Domínios válidos
Sub-picture_stream_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

SelectSubpictureStream