Método IDvdInfo2::GetCurrentSubpicture (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 GetCurrentSubpicture método recupera el número de secuencias de subpictura disponibles en el título actual, el número de secuencia de subpictura seleccionado actualmente y el estado de la subpictura.

Sintaxis

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

Parámetros

[out] pulStreamsAvailable

Recibe el número de secuencias de subpictura disponibles.

[out] pulCurrentStream

Recibe el número de la secuencia de subpictura seleccionada actualmente.

[out] pbIsDisabled

Recibe un valor booleano que indica si la pantalla de subpictura está deshabilitada; TRUE significa que está deshabilitado.

Valor devuelto

Devuelve uno de los siguientes valores HRESULT .

Código devuelto	Descripción
S_OK	Correcto.
E_POINTER	Argumento no válido.
VFW_E_DVD_INVALIDDOMAIN	El navegador de DVD no se inicializa o no está en el dominio title.

Comentarios

Los autores de contenido de DVD pueden especificar que cualquier secuencia de subpictura determinada en un disco se active forzadamente, lo que significa que los autores de DVD requieren esta secuencia para mostrar si el visor quiere watch él o no. El navegador de DVD cumple con todos estos comandos del disco, lo que significa que las secuencias activadas forzadamente se muestran incluso si la aplicación ha deshabilitado la visualización de subpicture con el método IDvdControl2::SetSubpictureState .

Requisitos

Requisito	Value
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 (incluya Dshow.h)
Library	Strmiids.lib

Consulte también

Aplicaciones de DVD

EC_DVD_SUBPICTURE_STREAM_CHANGE

Códigos de error y éxito

IDvdInfo2 (interfaz)