Share via

Método IDvdInfo2::GetSubpictureAttributes (strmif.h)

  • Artigo

[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 GetSubpictureAttributes método recupera os atributos do fluxo de subpictura especificado no título ou menu especificado.

Sintaxe

HRESULT GetSubpictureAttributes(
  [in]  ULONG                    ulStream,
  [out] DVD_SubpictureAttributes *pATR
);

Parâmetros

[in] ulStream

Número de índice, de 0 a 31, do fluxo de subpictura para consulta. Consulte Observações.

[out] pATR

Ponteiro para uma estrutura DVD_SubpictureAttributes que recebe os atributos de subpicture.

Retornar valor

Retorna um dos seguintes valores HRESULT .

Código de retorno Descrição
S_OK
 Êxito.
E_FAIL
 Nenhum fluxo de subpictura foi encontrado.
E_POINTER
 Argumento inválido.
VFW_E_DVD_NO_ATTRIBUTES
 A subpictura não tem atributos definidos.

Comentários

Os números de índice 0 a 31 são válidos apenas para títulos. Os menus têm apenas um fluxo de subpictura, que deve ser especificado usando uma das constantes na tabela abaixo:

Valor Descrição
DVD_STREAM_DATA_CURRENT (0x800) Para consultar o fluxo de subpictura selecionado no momento.
DVD_STREAM_DATA_VMGM (0x400) Para consultar os atributos de subpicture para o Gerenciador de Vídeo ou o Menu "Superior".
DVD_STREAM_DATA_VTSM (0x401) Para consultar os atributos de subpicture para o menu conjunto de títulos de vídeo selecionado no momento.
 

Esse método é demonstrado no aplicativo DVDSample em CDvdCore::GetSPAttributes() e CSPLangDlg::GetSPLang.

Requisitos

   
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

IDvdInfo2 Interface

Trabalhando com menus de DVD