DisplayManager Kelas

Definisi

Ruang nama:

Windows.Devices.Display.Core

Mengelola kepemilikan objek atau objek DisplayTarget , dan menyediakan metode untuk membuat objek 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

Warisan

Object Platform::Object IInspectable DisplayManager

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Penerapan

IClosable IDisposable

Persyaratan Windows

Rangkaian perangkat	Windows 10, version 1809 (diperkenalkan dalam 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v7.0)

Keterangan

Objek ini mengimplementasikan IClosable/IDisposable, yang harus digunakan untuk mencabut kepemilikan semua objek DisplayTarget setelah tidak lagi digunakan.

Metode

Close()	Mencabut kepemilikan semua objek DisplayTarget yang dimiliki oleh instans DisplayManager ini.
Create(DisplayManagerOptions)	Membuat instans DisplayManager dengan opsi yang ditentukan.
CreateDisplayDevice(DisplayAdapter)	Membuat objek DisplayDevice untuk adaptor yang diberikan. DisplayDevice dapat digunakan untuk membuat dan menyajikan konten layar penuh ke target pada adaptor yang diberikan.
Dispose()	Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, merilis, atau mengatur ulang sumber daya yang tidak dikelola.
GetCurrentAdapters()	Menghitung set adaptor tampilan yang saat ini ada pada sistem.
GetCurrentTargets()	Menghitung kumpulan target tampilan yang saat ini ada pada sistem.
ReleaseTarget(DisplayTarget)	Merilis kepemilikan target tampilan yang ditentukan, memungkinkan komponen lain pada sistem memperoleh kepemilikan.
Start()	Mulai mendengarkan semua peristiwa DisplayManager secara atomik. Kejadian DisplayManager tidak dinaikkan hingga Anda memanggil Mulai.
Stop()	Berhenti mendengarkan semua peristiwa DisplayManager secara atomik, dan memicu Dinonaktifkan secara sinkron.
TryAcquireTarget(DisplayTarget)	Mencoba memperoleh kepemilikan eksklusif displayTarget.
TryAcquireTargetsAndCreateEmptyState(IIterable<DisplayTarget>)	Mencoba untuk memperoleh kepemilikan eksklusif dari koleksi objek DisplayTarget , dan membuat objek DisplayState kosong yang dapat dimodifikasi, yang mendukung jalur penghubungan ke target ini.
TryAcquireTargetsAndCreateSubstate(DisplayState, IIterable<DisplayTarget>)	Mencoba untuk memperoleh kepemilikan eksklusif dari koleksi objek DisplayTarget , dan mengukir subset DisplayState tertentu hanya untuk target yang diteruskan ke metode ini. Status yang dihasilkan dapat dimodifikasi dan diterapkan.
TryAcquireTargetsAndReadCurrentState(IIterable<DisplayTarget>)	Mencoba untuk memperoleh kepemilikan eksklusif dari koleksi objek DisplayTarget , dan membuat DisplayState yang dapat dimodifikasi yang diisi dengan status target yang disediakan saat ini.
TryReadCurrentStateForAllTargets()	Membuat objek DisplayState baca-saja yang diisi dengan seluruh status tampilan sistem untuk semua target.

Acara

Changed	Kejadian yang dimunculkan ketika perangkat keras tampilan sistem ditambahkan, dihapus, atau dimodifikasi. Ini dapat terjadi setiap kali koleksi DisplayAdapter atau DisplayTarget berubah. Gunakan kejadian ini untuk mendeteksi perubahan ini dan memanggil GetCurrentAdapters dan/atau GetCurrentTargets untuk mendapatkan koleksi yang diperbarui.
Disabled	Peristiwa yang dimunculkan setiap kali tumpukan tampilan sesi saat ini dinonaktifkan, dan ketika DisplayManager.Stop dipanggil. Anda dapat menonaktifkan tumpukan tampilan sesi dalam beberapa kasus, seperti beralih sesi Layanan Terminal, atau untuk memulihkan dari kegagalan driver. Sebaiknya pelanggan mencoba membersihkan ketika Dinonaktifkan dipanggil. Sebagian besar API tampilan akan gagal saat tumpukan tampilan sesi dinonaktifkan.
Enabled	Peristiwa yang dimunculkan setiap kali tumpukan tampilan sesi saat ini diaktifkan, dan ketika DisplayManager.Start dipanggil. Anda dapat mengaktifkan kembali tumpukan tampilan sesi dalam beberapa kasus, seperti beralih sesi Layanan Terminal, atau untuk memulihkan dari kegagalan driver. Kami menyarankan agar pelanggan menghitung ulang semua target dan status dalam panggilan ini, karena tumpukan tampilan sistem dapat dibiarkan dalam status apa pun sebelum peristiwa ini dinaikkan.
PathsFailedOrInvalidated	Peristiwa yang dimunculkan setiap kali jalur tampilan gagal atau tidak valid secara asinkron oleh sistem. Hal ini dapat disebabkan oleh perubahan persyaratan bandwidth perangkat keras, atau karena kegagalan driver. Pelanggan untuk peristiwa ini harus memanggil TryAcquireTargetsAndReadCurrentState untuk target yang mereka miliki, dan memeriksa apakah salah satu jalur dalam objek DisplayState yang dihasilkan memiliki properti Status mereka diatur ke FailedAsync atau InvalidatedAsync, dan mengambil tindakan yang direkomendasikan.