Método IDvdInfo2::GetCurrentSubpicture (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 GetCurrentSubpicture método recupera o número de fluxos de subpictura disponíveis no título atual, o número de fluxo de subpictura atualmente selecionado e o estado da subpictura.

Sintaxe

HRESULT GetCurrentSubpicture(
  [out] ULONG *pulStreamsAvailable,
  [out] ULONG *pulCurrentStream,
  [out] BOOL  *pbIsDisabled
);

Parâmetros

[out] pulStreamsAvailable

Recebe o número de fluxos de subpictura disponíveis.

[out] pulCurrentStream

Recebe o número do fluxo de subpictura selecionado no momento.

[out] pbIsDisabled

Recebe um valor booliano que indica se a exibição de subpictura está desabilitada; TRUE significa que ele está desabilitado.

Retornar valor

Retorna um dos seguintes valores HRESULT .

Código de retorno	Descrição
S_OK	Êxito.
E_POINTER	Argumento inválido.
VFW_E_DVD_INVALIDDOMAIN	O Navegador de DVD não é inicializado ou não está no domínio Título.

Comentários

Os autores de conteúdo de DVD podem especificar que qualquer fluxo de subpictura específico em um disco seja ativado forçadamente, o que significa que os autores de DVD exigem esse fluxo para exibir se o visualizador deseja watch-lo ou não. O Navegador de DVD está em conformidade com todos esses comandos do disco, o que significa que os fluxos ativados forçadamente são exibidos mesmo se o aplicativo tiver desabilitado a exibição de subpictura com o método IDvdControl2::SetSubpictureState .

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

EC_DVD_SUBPICTURE_STREAM_CHANGE

Códigos de erro e êxito

IDvdInfo2 Interface