PnpObjectWatcher クラス

リファレンス

定義

名前空間:: Windows.Devices.Enumeration.Pnp

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

重要

Windows.Devices.Enumeration.Pnp 名前空間で型を使用することはお勧めしません。代わりに、Windows.Devices.Enumeration 名前空間の型は、Windows.Devices.Enumeration.Pnp の機能の最新の、より適切に保守されたスーパーセットを実装します。

PnpObjectType の代わりに、Windows.Devices.Enumeration.DeviceInformationKind 列挙型があり、パラメーターとして Windows.Devices.Enumeration API に渡すことができます。たとえば、PnpObjectWatcher を作成するときに PnpObjectType を使用する代わりに、DeviceWatcher を作成するときに DeviceInformationKind を使用します。

PnpObject が増分および非同期の方法で Pnp デバイスオブジェクトの列挙コレクションに追加、更新、または削除されたことをクライアントに通知するイベントを発生させます。

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

継承: Object Platform::Object IInspectable PnpObjectWatcher

属性: ContractVersionAttribute MarshalingBehaviorAttribute

Windows の要件

デバイスファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

注釈

アプリが Start を呼び出して、デバイスの検索を開始します。この初期列挙の間、PnpObjectWatcher は、すべてのデバイスが見つかるまで、検出された各デバイスに対して Added イベントを発生させます。 PnpObjectWatcher は、初期列挙が完了したときに EnumerationCompleted イベントを発生させ、デバイスが追加、更新、または削除された場合でもイベントを発生させ続けます。

次の図は、 DeviceWatcherStatus 列挙によって表される状態の間で PnpObjectWatcher がどのように遷移するかを示しています。

DeviceWatcher 状態の状態図

Start メソッドは、PnpObjectWatcher が Created、Stopped、または Aborted 状態の場合にのみ呼び出すことができます。 Status プロパティは、PnpObjectWatcher の状態を示します。ウォッチャーを再び起動するときは、Start を呼び出す前に Stopped イベントを待機します。

Stop を呼び出すと、PnpObjectWatcher が停止状態に遷移し、すぐに完了します。発生中の処理中のすべてのイベントが完了すると、ウォッチャーは停止状態に移行します。

Stop を呼び出した後、PnpObjectWatcher がいつ停止したかを知る必要がある場合、アプリは Stopped イベントを待機することがあります。呼び出し元は、Start を呼び出してウォッチャーを再起動する前に、Stopped イベントを待機する必要があります。呼び出し元は、 Stop の後に追加のイベントを受信したくないが、停止されたイベントを待機しない場合は、イベントのサブスクライブを解除できます。

プロパティ

Status

重要

非同期操作に関連付けられている状態。

メソッド

Start()

重要

PnpObject が追加、更新、または削除されたことをクライアントに通知するイベントの発生を開始します。

Stop()

重要

PnpObject が追加、更新、または削除されたことをクライアントに通知するイベントの発生を停止します。

イベント

Added	重要 Windows.Devices.Enumeration.Pnp 名前空間で型を使用することはお勧めしません。代わりに、Windows.Devices.Enumeration 名前空間の型は、Windows.Devices.Enumeration.Pnp の機能の最新の、より適切に保守されたスーパーセットを実装します。 PnpObjectType の代わりに、Windows.Devices.Enumeration.DeviceInformationKind 列挙型があり、パラメーターとして Windows.Devices.Enumeration API に渡すことができます。たとえば、PnpObjectWatcher を作成するときに PnpObjectType を使用する代わりに、DeviceWatcher を作成するときに DeviceInformationKind を使用します。 PnpObjectWatcher によって列挙されたコレクションに PnpObject が追加されたときに発生します。
EnumerationCompleted	重要 Windows.Devices.Enumeration.Pnp 名前空間で型を使用することはお勧めしません。代わりに、Windows.Devices.Enumeration 名前空間の型は、Windows.Devices.Enumeration.Pnp の機能の最新の、より適切に保守されたスーパーセットを実装します。 PnpObjectType の代わりに、Windows.Devices.Enumeration.DeviceInformationKind 列挙型があり、パラメーターとして Windows.Devices.Enumeration API に渡すことができます。たとえば、PnpObjectWatcher を作成するときに PnpObjectType を使用する代わりに、DeviceWatcher を作成するときに DeviceInformationKind を使用します。 Pnp デバイスオブジェクトの列挙が完了したときに発生します。
Removed	重要 Windows.Devices.Enumeration.Pnp 名前空間で型を使用することはお勧めしません。代わりに、Windows.Devices.Enumeration 名前空間の型は、Windows.Devices.Enumeration.Pnp の機能の最新の、より適切に保守されたスーパーセットを実装します。 PnpObjectType の代わりに、Windows.Devices.Enumeration.DeviceInformationKind 列挙型があり、パラメーターとして Windows.Devices.Enumeration API に渡すことができます。たとえば、PnpObjectWatcher を作成するときに PnpObjectType を使用する代わりに、DeviceWatcher を作成するときに DeviceInformationKind を使用します。 PnpObjectWatcher によって列挙されたコレクションから PnpObject が削除されたときに発生します。
Stopped	重要 Windows.Devices.Enumeration.Pnp 名前空間で型を使用することはお勧めしません。代わりに、Windows.Devices.Enumeration 名前空間の型は、Windows.Devices.Enumeration.Pnp の機能の最新の、より適切に保守されたスーパーセットを実装します。 PnpObjectType の代わりに、Windows.Devices.Enumeration.DeviceInformationKind 列挙型があり、パラメーターとして Windows.Devices.Enumeration API に渡すことができます。たとえば、PnpObjectWatcher を作成するときに PnpObjectType を使用する代わりに、DeviceWatcher を作成するときに DeviceInformationKind を使用します。 PnpObjectWatcher が Pnp デバイスオブジェクトのコレクションに対する変更の監視を停止したときに発生します。
Updated	重要 Windows.Devices.Enumeration.Pnp 名前空間で型を使用することはお勧めしません。代わりに、Windows.Devices.Enumeration 名前空間の型は、Windows.Devices.Enumeration.Pnp の機能の最新の、より適切に保守されたスーパーセットを実装します。 PnpObjectType の代わりに、Windows.Devices.Enumeration.DeviceInformationKind 列挙型があり、パラメーターとして Windows.Devices.Enumeration API に渡すことができます。たとえば、PnpObjectWatcher を作成するときに PnpObjectType を使用する代わりに、DeviceWatcher を作成するときに DeviceInformationKind を使用します。 PnpObjectWatcher によって列挙されたコレクション内の PnpObject のプロパティが更新されるときに発生します。

適用対象

次の方法で共有