PnpObjectWatcher Kelas

Definisi

Ruang nama:

Windows.Devices.Enumeration.Pnp

Penting

Kami tidak lagi menyarankan Agar Anda menggunakan jenis di namespace Layanan Windows.Devices.Enumeration.Pnp . Sebaliknya, jenis di namespace Windows.Devices.Enumeration mengimplementasikan superset modern, dan lebih terawat, dari fungsionalitas Windows.Devices.Enumeration.Pnp.

Alternatif untuk PnpObjectType adalah enum Windows.Devices.Enumeration.DeviceInformationKind , yang dapat Anda teruskan sebagai parameter ke WINDOWS.Devices.Enumeration API. Misalnya, alih-alih menggunakan PnpObjectType saat Anda membuat PnpObjectWatcher, gunakan DeviceInformationKind saat Anda membuat DeviceWatcher.

Meningkatkan peristiwa untuk memberi tahu klien bahwa PnpObject telah ditambahkan, diperbarui, atau dihapus dari koleksi enumerasi objek perangkat Pnp dengan cara inkremental dan asinkron.

public ref class PnpObjectWatcher sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class PnpObjectWatcher final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class PnpObjectWatcher

Public NotInheritable Class PnpObjectWatcher

Warisan

Object Platform::Object IInspectable PnpObjectWatcher

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Keterangan

Aplikasi memanggil Mulai untuk memulai pencarian perangkat. Selama enumerasi awal ini, PnpObjectWatcher menaikkan Peristiwa tambahan untuk setiap perangkat yang ditemukan, hingga semua perangkat ditemukan. PnpObjectWatcher memunculkan peristiwa EnumerationCompleted saat enumerasi awal selesai, dan terus menaikkan peristiwa jika perangkat ditambahkan, diperbarui, atau dihapus.

Diagram berikut menunjukkan bagaimana PnpObjectWatcher beralih antara status yang diwakili oleh enumerasi DeviceWatcherStatus .

Metode Mulai hanya dapat dipanggil ketika PnpObjectWatcher berada dalam status Dibuat, Dihentikan , atau Dibatalkan . Properti Status menunjukkan status PnpObjectWatcher. Saat memulai kembali pengamat, tunggu peristiwa Dihentikan sebelum memanggil Mulai.

Panggilan ke Hentikan transisi PnpObjectWatcher ke status Berhenti dan segera selesai. Pengamat akan beralih ke status Dihentikan setelah semua peristiwa yang sudah dalam proses dinaikkan telah selesai.

Setelah memanggil Berhenti, aplikasi mungkin menunggu peristiwa Dihentikan jika perlu mengetahui kapan PnpObjectWatcher telah berhenti. Penelepon harus menunggu peristiwa Dihentikan sebelum mereka dapat memanggil Mulai untuk memulai ulang pengamat. Penelepon mungkin berhenti berlangganan dari peristiwa jika mereka tidak ingin menerima peristiwa tambahan setelah Berhenti tetapi tidak ingin menunggu peristiwa Dihentikan .

Properti

Status

Penting Kami tidak lagi menyarankan Agar Anda menggunakan jenis di namespace Layanan Windows.Devices.Enumeration.Pnp . Sebaliknya, jenis di namespace Windows.Devices.Enumeration mengimplementasikan superset modern, dan lebih terawat, dari fungsionalitas Windows.Devices.Enumeration.Pnp. Alternatif untuk PnpObjectType adalah enum Windows.Devices.Enumeration.DeviceInformationKind , yang dapat Anda teruskan sebagai parameter ke WINDOWS.Devices.Enumeration API. Misalnya, alih-alih menggunakan PnpObjectType saat Anda membuat PnpObjectWatcher, gunakan DeviceInformationKind saat Anda membuat DeviceWatcher. Status yang terkait dengan operasi asinkron.

Metode

Start()

Penting Kami tidak lagi menyarankan Agar Anda menggunakan jenis di namespace Layanan Windows.Devices.Enumeration.Pnp . Sebaliknya, jenis di namespace Windows.Devices.Enumeration mengimplementasikan superset modern, dan lebih terawat, dari fungsionalitas Windows.Devices.Enumeration.Pnp. Alternatif untuk PnpObjectType adalah enum Windows.Devices.Enumeration.DeviceInformationKind , yang dapat Anda teruskan sebagai parameter ke WINDOWS.Devices.Enumeration API. Misalnya, alih-alih menggunakan PnpObjectType saat Anda membuat PnpObjectWatcher, gunakan DeviceInformationKind saat Anda membuat DeviceWatcher. Mulai menaikkan peristiwa untuk memberi tahu klien bahwa PnpObject telah ditambahkan, diperbarui, atau dihapus.

Stop()

Penting Kami tidak lagi menyarankan Agar Anda menggunakan jenis di namespace Layanan Windows.Devices.Enumeration.Pnp . Sebaliknya, jenis di namespace Windows.Devices.Enumeration mengimplementasikan superset modern, dan lebih terawat, dari fungsionalitas Windows.Devices.Enumeration.Pnp. Alternatif untuk PnpObjectType adalah enum Windows.Devices.Enumeration.DeviceInformationKind , yang dapat Anda teruskan sebagai parameter ke WINDOWS.Devices.Enumeration API. Misalnya, alih-alih menggunakan PnpObjectType saat Anda membuat PnpObjectWatcher, gunakan DeviceInformationKind saat Anda membuat DeviceWatcher. Berhenti menaikkan peristiwa untuk memberi tahu klien bahwa PnpObject telah ditambahkan, diperbarui, atau dihapus.

Acara

Added	Penting Kami tidak lagi menyarankan Agar Anda menggunakan jenis di namespace Layanan Windows.Devices.Enumeration.Pnp . Sebaliknya, jenis di namespace Windows.Devices.Enumeration mengimplementasikan superset modern, dan lebih terawat, dari fungsionalitas Windows.Devices.Enumeration.Pnp. Alternatif untuk PnpObjectType adalah enum Windows.Devices.Enumeration.DeviceInformationKind , yang dapat Anda teruskan sebagai parameter ke WINDOWS.Devices.Enumeration API. Misalnya, alih-alih menggunakan PnpObjectType saat Anda membuat PnpObjectWatcher, gunakan DeviceInformationKind saat Anda membuat DeviceWatcher. Terjadi ketika PnpObject ditambahkan ke koleksi yang dijumlahkan oleh PnpObjectWatcher.
EnumerationCompleted	Penting Kami tidak lagi menyarankan Agar Anda menggunakan jenis di namespace Layanan Windows.Devices.Enumeration.Pnp . Sebaliknya, jenis di namespace Windows.Devices.Enumeration mengimplementasikan superset modern, dan lebih terawat, dari fungsionalitas Windows.Devices.Enumeration.Pnp. Alternatif untuk PnpObjectType adalah enum Windows.Devices.Enumeration.DeviceInformationKind , yang dapat Anda teruskan sebagai parameter ke WINDOWS.Devices.Enumeration API. Misalnya, alih-alih menggunakan PnpObjectType saat Anda membuat PnpObjectWatcher, gunakan DeviceInformationKind saat Anda membuat DeviceWatcher. Terjadi ketika enumerasi objek perangkat Pnp telah selesai.
Removed	Penting Kami tidak lagi menyarankan Agar Anda menggunakan jenis di namespace Layanan Windows.Devices.Enumeration.Pnp . Sebaliknya, jenis di namespace Windows.Devices.Enumeration mengimplementasikan superset modern, dan lebih terawat, dari fungsionalitas Windows.Devices.Enumeration.Pnp. Alternatif untuk PnpObjectType adalah enum Windows.Devices.Enumeration.DeviceInformationKind , yang dapat Anda teruskan sebagai parameter ke WINDOWS.Devices.Enumeration API. Misalnya, alih-alih menggunakan PnpObjectType saat Anda membuat PnpObjectWatcher, gunakan DeviceInformationKind saat Anda membuat DeviceWatcher. Terjadi ketika PnpObject dihapus dari koleksi yang dijumlahkan oleh PnpObjectWatcher.
Stopped	Penting Kami tidak lagi menyarankan Agar Anda menggunakan jenis di namespace Layanan Windows.Devices.Enumeration.Pnp . Sebaliknya, jenis di namespace Windows.Devices.Enumeration mengimplementasikan superset modern, dan lebih terawat, dari fungsionalitas Windows.Devices.Enumeration.Pnp. Alternatif untuk PnpObjectType adalah enum Windows.Devices.Enumeration.DeviceInformationKind , yang dapat Anda teruskan sebagai parameter ke WINDOWS.Devices.Enumeration API. Misalnya, alih-alih menggunakan PnpObjectType saat Anda membuat PnpObjectWatcher, gunakan DeviceInformationKind saat Anda membuat DeviceWatcher. Terjadi ketika PnpObjectWatcher telah berhenti memantau perubahan pada pengumpulan objek perangkat Pnp.
Updated	Penting Kami tidak lagi menyarankan Agar Anda menggunakan jenis di namespace Layanan Windows.Devices.Enumeration.Pnp . Sebaliknya, jenis di namespace Windows.Devices.Enumeration mengimplementasikan superset modern, dan lebih terawat, dari fungsionalitas Windows.Devices.Enumeration.Pnp. Alternatif untuk PnpObjectType adalah enum Windows.Devices.Enumeration.DeviceInformationKind , yang dapat Anda teruskan sebagai parameter ke WINDOWS.Devices.Enumeration API. Misalnya, alih-alih menggunakan PnpObjectType saat Anda membuat PnpObjectWatcher, gunakan DeviceInformationKind saat Anda membuat DeviceWatcher. Terjadi ketika properti PnpObject dalam koleksi yang dijumlahkan oleh PnpObjectWatcher diperbarui.