PnpObjectWatcher Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Wichtig
Es wird nicht mehr empfohlen, die Typen im Windows.Devices.Enumeration.Pnp-Namespace zu verwenden. Stattdessen implementieren die Typen im Windows.Devices.Enumeration-Namespace eine moderne und besser gepflegte Übermenge der Funktionalität von Windows.Devices.Enumeration.Pnp.
Die Alternative zu PnpObjectType ist die Windows.Devices.Enumeration.DeviceInformationKind-Enumeum , die Sie als Parameter an Windows.Devices.Enumeration-APIs übergeben können. Anstatt beispielsweise PnpObjectType zu verwenden, wenn Sie einen PnpObjectWatcher erstellen, verwenden Sie DeviceInformationKind , wenn Sie einen DeviceWatcher erstellen.
Löst Ereignisse aus, um den Client zu benachrichtigen, dass ein PnpObject inkrementell und asynchron hinzugefügt, aktualisiert oder aus einer aufgezählten Auflistung von Pnp-Geräteobjekten entfernt wurde.
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
- Vererbung
- Attribute
Windows-Anforderungen
Gerätefamilie |
Windows 10 (eingeführt in 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
|
Hinweise
Eine App ruft Start auf, um mit der Suche nach Geräten zu beginnen. Während dieser ersten Enumeration löst der PnpObjectWatcher ein Added-Ereignis für jedes gefundene Gerät aus, bis alle Geräte gefunden werden. Der PnpObjectWatcher löst ein EnumerationCompleted-Ereignis aus, wenn die anfängliche Enumeration abgeschlossen ist, und löst weiterhin Ereignisse aus, wenn ein Gerät hinzugefügt, aktualisiert oder entfernt wird.
Das folgende Diagramm zeigt, wie der PnpObjectWatcher zwischen den durch die DeviceWatcherStatus-Enumeration dargestellten Zuständen wechselt.
Die Start-Methode kann nur aufgerufen werden, wenn sich der PnpObjectWatcher im Zustand Erstellt, Beendet oder Abgebrochen befindet . Die Status-Eigenschaft gibt den PnpObjectWatcher-Zustand an. Warten Sie beim erneuten Starten des Watchers auf das Ereignis Stopped , bevor Sie Start aufrufen.
Ein Aufruf von Stop überwechselt den PnpObjectWatcher in den Status Beenden und wird sofort abgeschlossen. Der Watcher wechselt in den Status Beendet , sobald alle Ereignisse abgeschlossen sind, die bereits ausgelöst werden.
Nach dem Aufrufen von Stop warten Apps möglicherweise auf das Ereignis Stopped , wenn sie wissen müssen, wann der PnpObjectWatcher beendet wurde. Anrufer müssen auf das Ereignis Beendet warten, bevor sie Start aufrufen können, um den Watcher neu zu starten. Anrufer können Ereignisse abbestellen, wenn sie nach dem Beenden keine weiteren Ereignisse erhalten möchten, aber nicht auf das Beendete Ereignis warten möchten.
Eigenschaften
Status |
Wichtig Es wird nicht mehr empfohlen, die Typen im Windows.Devices.Enumeration.Pnp-Namespace zu verwenden. Stattdessen implementieren die Typen im Windows.Devices.Enumeration-Namespace eine moderne und besser gepflegte Übermenge der Funktionalität von Windows.Devices.Enumeration.Pnp. Die Alternative zu PnpObjectType ist die Windows.Devices.Enumeration.DeviceInformationKind-Enumeum , die Sie als Parameter an Windows.Devices.Enumeration-APIs übergeben können. Anstatt beispielsweise PnpObjectType zu verwenden, wenn Sie einen PnpObjectWatcher erstellen, verwenden Sie DeviceInformationKind , wenn Sie einen DeviceWatcher erstellen. Die status, die dem asynchronen Vorgang zugeordnet sind. |
Methoden
Start() |
Wichtig Es wird nicht mehr empfohlen, die Typen im Windows.Devices.Enumeration.Pnp-Namespace zu verwenden. Stattdessen implementieren die Typen im Windows.Devices.Enumeration-Namespace eine moderne und besser gepflegte Übermenge der Funktionalität von Windows.Devices.Enumeration.Pnp. Die Alternative zu PnpObjectType ist die Windows.Devices.Enumeration.DeviceInformationKind-Enumeum , die Sie als Parameter an Windows.Devices.Enumeration-APIs übergeben können. Anstatt beispielsweise PnpObjectType zu verwenden, wenn Sie einen PnpObjectWatcher erstellen, verwenden Sie DeviceInformationKind , wenn Sie einen DeviceWatcher erstellen. Startet das Auslösen der Ereignisse, um den Client darüber zu informieren, dass ein PnpObject hinzugefügt, aktualisiert oder entfernt wurde. |
Stop() |
Wichtig Es wird nicht mehr empfohlen, die Typen im Windows.Devices.Enumeration.Pnp-Namespace zu verwenden. Stattdessen implementieren die Typen im Windows.Devices.Enumeration-Namespace eine moderne und besser gepflegte Übermenge der Funktionalität von Windows.Devices.Enumeration.Pnp. Die Alternative zu PnpObjectType ist die Windows.Devices.Enumeration.DeviceInformationKind-Enumeum , die Sie als Parameter an Windows.Devices.Enumeration-APIs übergeben können. Anstatt beispielsweise PnpObjectType zu verwenden, wenn Sie einen PnpObjectWatcher erstellen, verwenden Sie DeviceInformationKind , wenn Sie einen DeviceWatcher erstellen. Beendet das Auslösen der Ereignisse, um den Client darüber zu informieren, dass ein PnpObject hinzugefügt, aktualisiert oder entfernt wurde. |
Ereignisse
Added |
Wichtig Es wird nicht mehr empfohlen, die Typen im Windows.Devices.Enumeration.Pnp-Namespace zu verwenden. Stattdessen implementieren die Typen im Windows.Devices.Enumeration-Namespace eine moderne und besser gepflegte Übermenge der Funktionalität von Windows.Devices.Enumeration.Pnp. Die Alternative zu PnpObjectType ist die Windows.Devices.Enumeration.DeviceInformationKind-Enumeum , die Sie als Parameter an Windows.Devices.Enumeration-APIs übergeben können. Anstatt beispielsweise PnpObjectType zu verwenden, wenn Sie einen PnpObjectWatcher erstellen, verwenden Sie DeviceInformationKind , wenn Sie einen DeviceWatcher erstellen. Tritt auf, wenn ein PnpObject zur Auflistung hinzugefügt wird, die vom PnpObjectWatcher aufgelistet wird. |
EnumerationCompleted |
Wichtig Es wird nicht mehr empfohlen, die Typen im Windows.Devices.Enumeration.Pnp-Namespace zu verwenden. Stattdessen implementieren die Typen im Windows.Devices.Enumeration-Namespace eine moderne und besser gepflegte Übermenge der Funktionalität von Windows.Devices.Enumeration.Pnp. Die Alternative zu PnpObjectType ist die Windows.Devices.Enumeration.DeviceInformationKind-Enumeum , die Sie als Parameter an Windows.Devices.Enumeration-APIs übergeben können. Anstatt beispielsweise PnpObjectType zu verwenden, wenn Sie einen PnpObjectWatcher erstellen, verwenden Sie DeviceInformationKind , wenn Sie einen DeviceWatcher erstellen. Tritt auf, wenn die Enumeration der Pnp-Geräteobjekte abgeschlossen wurde. |
Removed |
Wichtig Es wird nicht mehr empfohlen, die Typen im Windows.Devices.Enumeration.Pnp-Namespace zu verwenden. Stattdessen implementieren die Typen im Windows.Devices.Enumeration-Namespace eine moderne und besser gepflegte Übermenge der Funktionalität von Windows.Devices.Enumeration.Pnp. Die Alternative zu PnpObjectType ist die Windows.Devices.Enumeration.DeviceInformationKind-Enumeum , die Sie als Parameter an Windows.Devices.Enumeration-APIs übergeben können. Anstatt beispielsweise PnpObjectType zu verwenden, wenn Sie einen PnpObjectWatcher erstellen, verwenden Sie DeviceInformationKind , wenn Sie einen DeviceWatcher erstellen. Tritt auf, wenn ein PnpObject aus der Auflistung entfernt wird, die vom PnpObjectWatcher aufgelistet wird. |
Stopped |
Wichtig Es wird nicht mehr empfohlen, die Typen im Windows.Devices.Enumeration.Pnp-Namespace zu verwenden. Stattdessen implementieren die Typen im Windows.Devices.Enumeration-Namespace eine moderne und besser gepflegte Übermenge der Funktionalität von Windows.Devices.Enumeration.Pnp. Die Alternative zu PnpObjectType ist die Windows.Devices.Enumeration.DeviceInformationKind-Enumeum , die Sie als Parameter an Windows.Devices.Enumeration-APIs übergeben können. Anstatt beispielsweise PnpObjectType zu verwenden, wenn Sie einen PnpObjectWatcher erstellen, verwenden Sie DeviceInformationKind , wenn Sie einen DeviceWatcher erstellen. Tritt auf, wenn der PnpObjectWatcher die Überwachung von Änderungen an der Auflistung von Pnp-Geräteobjekten beendet hat. |
Updated |
Wichtig Es wird nicht mehr empfohlen, die Typen im Windows.Devices.Enumeration.Pnp-Namespace zu verwenden. Stattdessen implementieren die Typen im Windows.Devices.Enumeration-Namespace eine moderne und besser gepflegte Übermenge der Funktionalität von Windows.Devices.Enumeration.Pnp. Die Alternative zu PnpObjectType ist die Windows.Devices.Enumeration.DeviceInformationKind-Enumeum , die Sie als Parameter an Windows.Devices.Enumeration-APIs übergeben können. Anstatt beispielsweise PnpObjectType zu verwenden, wenn Sie einen PnpObjectWatcher erstellen, verwenden Sie DeviceInformationKind , wenn Sie einen DeviceWatcher erstellen. Tritt auf, wenn die Eigenschaften eines PnpObject in der Auflistung aktualisiert werden, die vom PnpObjectWatcher aufgezählt wird. |