Método IDvdControl2::SetSubpictureState (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 SetSubpictureState método activa o desactiva la presentación de la subpictura.

Sintaxis

HRESULT SetSubpictureState(
  [in]  BOOL    bState,
  [in]  DWORD   dwFlags,
  [out] IDvdCmd **ppCmd
);

Parámetros

[in] bState

Valor booleano que especifica si la presentación de la subpictura está activada; TRUE establece la presentación de subpicture en para la reproducción posterior.

[in] dwFlags

OR bit a bit de una o varias marcas de la enumeración DVD_CMD_FLAGS , especificando cómo sincronizar el comando.

[out] ppCmd

Recibe un puntero a un objeto IDvdCmd que se puede usar para sincronizar comandos de DVD. El autor de la llamada debe liberar la interfaz . Este parámetro puede ser NULL. Para obtener más información, vea Sincronizar comandos de DVD.

Valor devuelto

Devuelve uno de los valores siguientes.

Código devuelto	Descripción
S_OK	Correcto.
VFW_E_DVD_INVALIDDOMAIN	El navegador de DVD está en el dominio First Play.
VFW_E_DVD_OPERATION_INHIBITED	El control UOP prohíbe la operación.

Comentarios

Las secuencias de subpictura se suelen usar en menús para el texto del botón y, a veces, los gráficos del botón, y en la reproducción de vídeo para subtítulos, créditos u otros gráficos superpuestos. No confunda subpicturas con subtítulos; este último se codifica dentro de la secuencia de vídeo. En general, este método está diseñado para controlar la presentación de subpicturas sobre vídeo mientras el filtro navegador de DVD está reproduciendo vídeo en el dominio de título de DVD.

Este método corresponde al segundo parámetro del comando "Sub-picture_Stream_Change" del anexo J.

En la tabla siguiente se muestra el nombre del comando Anexo J al que corresponde este nombre de método y los dominios en los que este método es válido.

Nombre del comando Anexo J	Dominios válidos
Sub-picture_stream_Change	DVD_DOMAIN_VideoManagerMenu DVD_DOMAIN_VideoTitleSetMenu DVD_DOMAIN_Title DVD_DOMAIN_Stop

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

Consulte también

Aplicaciones de DVD

Códigos de error y éxito

IDvdControl2 (interfaz)

SelectSubpictureStream