IWSDDeviceProxy

クライアントアプリケーションおよびミドルウェアに対して、リモートの Devices Profile for Web Services (DPWS) デバイスを表します。

このインターフェイスは、リモートデバイスのクライアント側表現です。このプロキシは、デバイスのメタデータ (WSD_THIS_DEVICE_METADATA および WSD_THIS_MODEL_METADATA) への基本的なアクセス手段に加え、サービスプロキシオブジェクトを作成するメソッドを提供します。サービスプロキシオブジェクトは、デバイス上でホストされるサービスに対応します。たとえば、テレビはデバイスであり、テレビのチューナー部分は、アクセス可能で不可分な機能の集合を持つ、デバイス上でホストされるサービスです。

IWSDDeviceProxy オブジェクトは、WSD 固有のデバイスセマンティクスを公開します。

クライアントアプリケーションまたはミドルウェアアプリケーションで IWSDDeviceProxy を使用するには、次の手順を実行します。

1. WSDCreateDeviceProxy を呼び出します。
2. デバイスプロキシオブジェクトの 4 つのメタデータメソッドのいずれかを呼び出します。
3. GetServiceProxyById または GetServiceProxyByType を呼び出して、IWSDServiceProxy オブジェクトを取得します。

デバイスプロキシを初期化します。必要に応じて、既に初期化済みのスポンサーとなるデバイスプロキシとセッションを共有します。

戻り値には次のものが含まれますが、これらに限定されません。

このメソッドは WSDCreateDeviceProxy から呼び出されるため、通常はクライアントコードから直接呼び出す必要はありません。

メタデータの非同期要求を送信します。

このメソッドは次のいずれかの値を返します。

戻り値には次のものが含まれますが、これらに限定されません。

BeginGetMetadata は、デバイスプロキシに対してホストへのメタデータ要求の送信を強制します。EndGetMetadata が呼び出されると、最新のメタデータ取得結果に GetAllMetadata、GetHostMetadata、GetThisDeviceMetadata、GetThisModelMetadata の各メソッドからアクセスできるようになります。

メタデータの非同期要求を終了します。

戻り値には次のものが含まれますが、これらに限定されません。

EndGetMetadata は、BeginGetMetadata によって返された IWSDAsyncResult オブジェクトが操作の完了を示した後にのみ呼び出す必要があります。EndGetMetadata が呼び出されると、最新のメタデータ取得結果に GetAllMetadata、GetHostMetadata、GetThisDeviceMetadata、GetThisModelMetadata の各メソッドからアクセスできるようになります。

デバイスの機能およびデバイスがホストするサービスを記述する、デバイスのクラス固有メタデータを取得します。

このメソッドは次のいずれかの値を返します。

戻り値には次のものが含まれますが、これらに限定されません。

GetHostMetadata は、デバイスプロキシにデバイスからのメタデータ取得を行わせません。代わりに、GetHostMetadata は BeginGetMetadata および EndGetMetadata の最後の呼び出しで取得されたメタデータを返します。これらのメソッドがいずれも呼び出されていない場合、GetHostMetadata は IWSDDeviceProxy オブジェクトの初期化時に取得されたメタデータを返します。

成功した場合、ppMetadata のメモリは、BeginGetMetadata または EndGetMetadata が呼び出されるまで、あるいは IWSDDeviceProxy オブジェクトが解放されるまで有効です。

デバイスのモデル固有メタデータを取得します。

このメソッドは次のいずれかの値を返します。

戻り値には次のものが含まれますが、これらに限定されません。

GetThisModelMetadata は、デバイスプロキシにデバイスからのメタデータ取得を行わせません。代わりに、GetThisModelMetadata は BeginGetMetadata および EndGetMetadata の最後の呼び出しで取得されたメタデータを返します。これらのメソッドがいずれも呼び出されていない場合、GetThisModelMetadata は IWSDDeviceProxy オブジェクトの初期化時に取得されたメタデータを返します。

成功した場合、ppMetadata のメモリは、BeginGetMetadata または EndGetMetadata が呼び出されるまで、あるいは IWSDDeviceProxy オブジェクトが解放されるまで有効です。

このデバイスのデバイス固有メタデータを取得します。

このメソッドは次のいずれかの値を返します。

戻り値には次のものが含まれますが、これらに限定されません。

GetThisDeviceMetadata は、デバイスプロキシにデバイスからのメタデータ取得を行わせません。代わりに、GetThisDeviceMetadata は BeginGetMetadata および EndGetMetadata の最後の呼び出しで取得されたメタデータを返します。これらのメソッドがいずれも呼び出されていない場合、GetThisDeviceMetadata は IWSDDeviceProxy オブジェクトの初期化時に取得されたメタデータを返します。

成功した場合、ppMetadata のメモリは、BeginGetMetadata または EndGetMetadata が呼び出されるまで、あるいは IWSDDeviceProxy オブジェクトが解放されるまで有効です。

このデバイスのすべてのメタデータを取得します。

このメソッドは次のいずれかの値を返します。

戻り値には次のものが含まれますが、これらに限定されません。

このメソッドは、拡張メタデータにアクセスできるようにするために提供されています。製造元、サービスホスト、およびデバイス固有のメタデータは、それぞれの目的専用に用意されたメソッドを使用して取得するのが最適です。

GetAllMetadata は、デバイスプロキシにデバイスからのメタデータ取得を行わせません。代わりに、GetAllMetadata は BeginGetMetadata および EndGetMetadata の最後の呼び出しで取得されたメタデータを返します。これらのメソッドがいずれも呼び出されていない場合、GetAllMetadata は IWSDDeviceProxy オブジェクトの初期化時に取得されたメタデータを返します。

成功した場合、ppMetadata のメモリは、BeginGetMetadata または EndGetMetadata が呼び出されるまで、あるいは IWSDDeviceProxy オブジェクトが解放されるまで有効です。

サービス ID を指定して、汎用の IWSDServiceProxy サービスプロキシを取得します。

戻り値には次のものが含まれますが、これらに限定されません。

ポート型名を指定して、デバイスが公開するサービスの汎用 IWSDServiceProxy プロキシを取得します。

戻り値には次のものが含まれますが、これらに限定されません。

デバイスが指定された型のサービスを複数ホストしている場合、そのうちいずれか 1 つのサービスのプロキシが返される可能性があります。そのような場合、呼び出し元は特定のサービスプロキシが返されることを前提にしないでください。

デバイスのエンドポイントプロキシを取得します。

このメソッドは次のいずれかの値を返します。

戻り値には次のものが含まれますが、これらに限定されません。