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
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.