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

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El GetSubpictureAttributes método recupera los atributos de la secuencia de subpictura especificada en el título o menú especificados.

Sintaxis

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

Parámetros

[in] ulStream

Número de índice, de 0 a 31, del flujo de subpictura que se va a consultar. Vea la sección Comentarios.

[out] pATR

Puntero a una estructura DVD_SubpictureAttributes que recibe los atributos de subpicture.

Valor devuelto

Devuelve uno de los siguientes valores HRESULT .

Código devuelto	Descripción
S_OK	Correcto.
E_FAIL	No se encontraron secuencias de subpicturas.
E_POINTER	Argumento no válido.
VFW_E_DVD_NO_ATTRIBUTES	La subpictura no tiene atributos definidos.

Observaciones

Los números de índice 0-31 solo son válidos para los títulos. Los menús solo tienen un flujo de subpictura, que se debe especificar mediante una de las constantes de la tabla siguiente:

Valor	Descripción
DVD_STREAM_DATA_CURRENT (0x800)	Para consultar la secuencia de subpictura seleccionada actualmente.
DVD_STREAM_DATA_VMGM (0x400)	Para consultar los atributos de subpicture del Menú "Superior" o del Administrador de vídeos.
DVD_STREAM_DATA_VTSM (0x401)	Para consultar los atributos de subpicture del menú de conjunto de títulos de vídeo seleccionado actualmente.

 

Este método se muestra en la aplicación DVDSample en CDvdCore::GetSPAttributes() y CSPLangDlg::GetSPLang.

Requisitos

Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	strmif.h (incluye Dshow.h)
Library	Strmiids.lib

Consulte también

Aplicaciones de DVD

Códigos de error y éxito

IDvdInfo2 (Interfaz)

Trabajar con menús de DVD