Método IDvdControl2::SelectSubpictureStream (strmif.h)

Artículo
07/28/2023

[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 SelectSubpictureStream método establece la secuencia de subpicture que se va a mostrar.

Sintaxis

HRESULT SelectSubpictureStream(
        ULONG   ulSubPicture,
  [in]  DWORD   dwFlags,
  [out] IDvdCmd **ppCmd
);

Parámetros

ulSubPicture

Valor que especifica la secuencia de subpictura, que debe ser de 0 a 31 o 63.

Valor	Descripción
0-31	La secuencia es válida.
63	La secuencia es la secuencia ficticía, lo que significa que es una secuencia silenciada y de velocidad de bits baja.

[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.
E_INVALIDARG	ulSubPicture está fuera del intervalo o no se corresponde con una secuencia sp.
E_UNEXPECTED	El parámetro ulSubPicture es válido, pero DVD Navigator no puede establecerlo por algún otro motivo.
VFW_E_DVD_OPERATION_INHIBITED	El control UOP prohíbe la operación.
VFW_E_DVD_INVALIDDOMAIN	dominio no válido.
VFW_E_DVD_STREAM_DISABLED	La secuencia especificada está deshabilitada.

Observaciones

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 de comando de Anexo J	Dominios válidos
Sub-picture_Stream_Change	DVD_DOMAIN_VideoManagerMenu DVD_DOMAIN_VideoTitleSetMenu DVD_DOMAIN_Title DVD_DOMAIN_Stop

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

Consulte también

Secuencias de audio y subpictura

Aplicaciones de DVD

Códigos de error y éxito

Interfaz IDvdControl2

Share via