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 |
|---|---|
|
Correcto. |
|
No se encontraron secuencias de subpicturas. |
|
Argumento no válido. |
|
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 |