DisplayManager Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Administra la propiedad de un objeto o objetos DisplayTarget y proporciona métodos para crear objetos DisplayState .
public ref class DisplayManager sealed : IClosable
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 458752)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DisplayManager final : IClosable
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 458752)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DisplayManager : System.IDisposable
Public NotInheritable Class DisplayManager
Implements IDisposable
- Herencia
- Atributos
- Implementaciones
Requisitos de Windows
Familia de dispositivos |
Windows 10, version 1809 (se introdujo en la versión 10.0.17763.0)
|
API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v7.0)
|
Comentarios
Este objeto implementa IDisposable IClosable/, que se debe usar para revocar la propiedad de todos los objetos DisplayTarget una vez que ya no se usen.
Métodos
Close() |
Revoca la propiedad de todos los objetos DisplayTarget que pertenecen a esta instancia de DisplayManager . |
Create(DisplayManagerOptions) |
Crea una instancia de DisplayManager con las opciones especificadas. |
CreateDisplayDevice(DisplayAdapter) |
Crea un objeto DisplayDevice para el adaptador especificado. DisplayDevice se puede usar para crear y presentar contenido de pantalla completa a destinos en el adaptador determinado. |
CreateDisplayDeviceForIndirectAdapter(DisplayAdapter, DisplayAdapter) |
Administra la propiedad de un objeto o objetos DisplayTarget y proporciona métodos para crear objetos DisplayState . |
Dispose() |
Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados. |
GetCurrentAdapters() |
Enumera el conjunto de adaptadores de pantalla presentes actualmente en el sistema. |
GetCurrentTargets() |
Enumera el conjunto de destinos de visualización presentes actualmente en el sistema. |
ReleaseTarget(DisplayTarget) |
Libera la propiedad del destino de presentación especificado, lo que permite que otros componentes del sistema adquieran propiedad. |
Start() |
Comienza a escuchar todos los eventos de DisplayManager de forma atómica. Los eventos displayManager no se generan hasta que se llama a Start. |
Stop() |
Deja de escuchar todos los eventos de DisplayManager de forma atómica y desencadena Deshabilitado de forma sincrónica. |
TryAcquireTarget(DisplayTarget) |
Intenta adquirir la propiedad exclusiva de un displayTarget. |
TryAcquireTargetsAndCreateEmptyState(IIterable<DisplayTarget>) |
Intenta adquirir la propiedad exclusiva de una colección de objetos DisplayTarget y crea un objeto DisplayState modificable vacío, que admite la conexión de rutas de acceso a estos destinos. |
TryAcquireTargetsAndCreateSubstate(DisplayState, IIterable<DisplayTarget>) |
Intenta adquirir la propiedad exclusiva de una colección de objetos DisplayTarget y elimina un subconjunto de un displayState determinado solo para los destinos pasados a este método. El estado resultante se puede modificar y aplicar. |
TryAcquireTargetsAndReadCurrentState(IIterable<DisplayTarget>) |
Intenta adquirir la propiedad exclusiva de una colección de objetos DisplayTarget y crea un DisplayState modificable rellenado con el estado actual de los destinos proporcionados. |
TryReadCurrentStateForAllTargets() |
Crea un objeto DisplayState de solo lectura rellenado con todo el estado de visualización del sistema para todos los destinos. |
TryReadCurrentStateForModeQuery() |
Administra la propiedad de un objeto o objetos DisplayTarget y proporciona métodos para crear objetos DisplayState . |
Eventos
Changed |
Evento que se genera cuando se agrega, quita o modifica el hardware de visualización del sistema. Esto puede ocurrir siempre que cambien las colecciones DisplayAdapter o DisplayTarget . Use este evento para detectar estos cambios y llamar a GetCurrentAdapters o GetCurrentTargets para obtener las colecciones actualizadas. |
Disabled |
Evento generado cada vez que se deshabilita la pila de visualización de la sesión actual y cuando se llama a DisplayManager.Stop . Puede deshabilitar la pila de visualización de sesión en varios casos, como cambiar las sesiones de Terminal Services o recuperarse de errores de controladores. Se recomienda que los suscriptores intenten limpiar cuando se invoque Disabled . Se producirá un error en la mayoría de las API de visualización mientras la pila de visualización de la sesión está deshabilitada. |
Enabled |
Evento generado cada vez que se habilita la pila de visualización de la sesión actual y cuando se llama a DisplayManager.Start . Puede volver a habilitar la pila de visualización de sesión en varios casos, como cambiar las sesiones de Terminal Services o recuperarse de errores de controladores. Se recomienda que los suscriptores vuelvan a enumerar todos los destinos y el estado de esta llamada, ya que la pila de visualización del sistema podría dejarse en cualquier estado antes de que se genere este evento. |
PathsFailedOrInvalidated |
Evento que se genera cada vez que el sistema produce un error o invalida una ruta de acceso de presentación. Esto puede deberse a cambios en los requisitos de ancho de banda de hardware o debido a errores de controladores. Los suscriptores a este evento deben llamar a TryAcquireTargetsAndReadCurrentState para los destinos que poseen y comprobar si alguna de las rutas de acceso del objeto DisplayState resultante tiene su propiedad Status establecida en FailedAsync o InvalidatedAsync, y realizar la acción recomendada. |