Método IDvdInfo2::GetSubpictureAttributes (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 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 |
|---|---|
|
Êxito. |
|
Nenhum fluxo de subpictura foi encontrado. |
|
Argumento inválido. |
|
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 |