Propiedad IWMPClosedCaption::SAMIFileName

[La característica asociada a esta página, Reproductor multimedia de Windows SDK, es una característica heredada. Se ha reemplazado por MediaPlayer. MediaPlayer se ha optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer en lugar de Reproductor multimedia de Windows SDK, 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.

La propiedad SAMIFileName obtiene o establece el nombre de un archivo que contiene la información necesaria para el subtítulo.

Sintaxis

public System.String SAMIFileName {get; set;}

Public Property SAMIFileName As System.String

Valor de propiedad

System.String que es el nombre del archivo de intercambio de medios accesibles sincronizado (SAMI).

Observaciones

El archivo SAMI debe usar una extensión de nombre de archivo .smi o .sami.

Si no establece un valor mediante SAMIFileName, esta propiedad obtiene una cadena que contiene el nombre de archivo predeterminado o la dirección URL asociada al elemento multimedia actual. Esta asociación puede producirse cuando se especifica un archivo SAMI mediante el parámetro sami URL o automáticamente cuando el archivo SAMI tiene el mismo nombre que el archivo multimedia digital (excepto la extensión de nombre de archivo). Si no hay ningún archivo SAMI predeterminado asociado con el medio actual, esta propiedad obtiene una cadena de longitud cero ("").

Una vez establecido un valor mediante SAMIFileName, ese valor persiste hasta que se establece un nuevo valor (o hasta que se abra un nuevo elemento multimedia mediante el parámetro sami URL). Por lo tanto, debe establecer un nuevo valor para esta propiedad antes de reproducir cada nuevo elemento multimedia. De este modo, el nuevo valor de SAMIFileName surtirá efecto cuando se abra el siguiente elemento multimedia (o cuando se llame a AxWindowsMediaPlayer.close ). Especificar un nuevo valor para SAMIFileName no tiene ningún efecto para el medio actual.

Para hacer que Reproductor multimedia de Windows use el archivo SAMI predeterminado asociado a un elemento multimedia determinado, establezca SAMIFileName en una cadena de longitud cero ("") antes de reproducir el siguiente elemento multimedia.

Requisitos

Requisito	Value
Versión	Reproductor multimedia de Windows serie 9 o posterior
Espacio de nombres	WMPLib
Ensamblado	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

Consulte también

Agregar subtítulos a medios digitales

AxWindowsMediaPlayer.close

Interfaz IWMPClosedCaption (VB y C#)

Interfaz IWMPClosedCaption2 (VB y C#)