Interfaz de IWMProfile

[La característica asociada a esta página, SDK de Windows Media Format 11, es una característica heredada. Se ha reemplazado por lector de origen y escritor receptor. Lector de origen y escritor receptor se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use lector de origen y escritor receptor en lugar del SDK de Windows Media Format 11, 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 interfaz IWMProfile es la interfaz principal de un objeto de perfil . Se usa un objeto de perfil para configurar perfiles personalizados. Puede usar IWMProfile para crear, eliminar o modificar objetos de configuración de secuencia y objetos de exclusión mutua. También puede establecer y recuperar información general sobre el perfil. Para acceder a todas las características del objeto de perfil, debe usar IWMProfile3, que hereda de IWMProfile e IWMProfile2.

IWMProfile también es accesible a través del objeto reader, donde puede usarlo para obtener información sobre las secuencias de un archivo que se carga en el lector. Al acceder a IWMProfile desde el lector, puede realizar cambios en el perfil, pero ninguno de los cambios se puede guardar en el archivo. A menudo es útil usar el perfil de un archivo existente como base de un nuevo perfil. El lector sincrónico admite IWMProfile de la misma manera que el lector.

La información de perfil obtenida a través del lector o del lector sincrónico no procede de un archivo .prx. El lector usa la información del archivo ASF para ensamblar las configuraciones de secuencia. Por lo tanto, cierta información de perfil, como el nombre y la descripción, no están disponibles a través del lector.

Hay varias maneras de obtener un puntero a una interfaz IWMProfile . El administrador de perfiles tiene métodos para crear un nuevo perfil y acceder a los perfiles existentes. Todos estos métodos establecen un puntero IWMProfile . Al leer un archivo, se puede obtener un puntero a IWMProfile llamando al método QueryInterface de cualquier interfaz de lector. Del mismo modo, cualquier interfaz del objeto de lector sincrónico puede obtener un puntero con una llamada a QueryInterfaceIWMProfile3.

Miembros

La interfaz IWMProfile hereda de la interfaz IUnknown . IWMProfile también tiene estos tipos de miembros:

• Métodos

Métodos

La interfaz IWMProfile tiene estos métodos.

Método	Descripción
AddMutualExclusion	Agrega un objeto de exclusión mutua al perfil.
AddStream	Agrega una secuencia al perfil.
CreateNewMutualExclusion	Crea un objeto de exclusión mutua para el perfil.
CreateNewStream	Crea un objeto de configuración de flujo para el perfil.
GetDescription	Recupera la descripción del perfil.
GetMutualExclusion	Recupera un objeto de exclusión mutua del perfil.
GetMutualExclusionCount	Recupera el número de objetos de exclusión mutua en el perfil.
GetName	Recupera el nombre del perfil.
GetStream	Recupera una secuencia, mediante un número de índice, del perfil.
GetStreamByNumber	Recupera una secuencia, con el número de la secuencia, del perfil.
GetStreamCount	Recupera el número de secuencias del perfil.
GetVersion	Recupera el número de versión de Microsoft Windows Media Services en el perfil.
Volver a configurarStream	Permite que los cambios realizados en una configuración de flujo se incluyan en el perfil.
RemoveMutualExclusion	Quita un objeto de exclusión mutua del perfil.
RemoveStream	Quita una secuencia del perfil.
RemoveStreamByNumber	Quita una secuencia del perfil.
SetDescription	Especifica la descripción del perfil.
SetName	Especifica el nombre del perfil.

Para obtener información sobre qué interfaces se pueden obtener mediante el método QueryInterface de esta interfaz, vea el tema del objeto en el que se implementa esta interfaz.

Consulte también

Interfaces

Interfaz IWMProfileManager

Objeto del administrador de perfiles

Objeto del lector

Objeto del lector sincrónico

Trabajar con perfiles