IUPnPDeviceControl

IUPnPDeviceControl インターフェイスは、デバイスとそのサービス オブジェクトを管理する中心的な役割を担います。

Initialize メソッドは、デバイスを初期化するために使用します。このメソッドはデバイス ホストによって呼び出されます。

このメソッドを実装する場合、成功したときは S_OK を返します。それ以外の場合は、WinError.h に定義されている COM エラー コードのいずれかを返します。

このメソッドは、デバイス コントロール オブジェクトがインスタンス化された直後に呼び出されます。 IUPnPDeviceControl::GetServiceObject よりも前に呼び出される必要があります。

実行中のデバイスとそうでないデバイスの違いは、 Initialize メソッドが呼び出されるタイミングにあります。

実行中のデバイスの場合、 Initialize は IUPnPRegistrar::RegisterRunningDevice の呼び出し時に呼び出され、IUPnPRegistrar::RegisterRunningDevice が復帰する前に初期化が完了します。

実行中でないデバイスの場合、 IUPnPRegistrar::RegisterDevice の呼び出し時に Initialize が呼び出されるとは限りません。 Initialize は、最初のコントロール要求またはイベント要求が到着した時点で呼び出されます。

bstrDeviceIdentifier は、 IUPnPRegistrar::GetUniqueDeviceName を呼び出す際にも使用できます。

GetServiceObject メソッドは、特定のサービス オブジェクトへの IDispatch ポインターを取得するために使用します。デバイス ホストは、あるサービスに対する要求を最初に受け取ったときに、そのサービスごとに 1 回このメソッドを呼び出します。

このメソッドを実装する場合、成功したときは S_OK を返します。それ以外の場合は、WinError.h に定義されている COM エラー コードのいずれかを返します。

このメソッドは、特定のサービスに対するコントロール要求またはイベント サブスクリプションを受信したときに、デバイス ホストによって呼び出されます。

埋め込みデバイスは、それぞれの UDN によって区別されます。