デバイスホストにデバイスを登録する方法

  • [アーティクル]

実行中のデバイスまたは実行中でないデバイスを登録できます。

実行中のデバイスの登録

デバイスは、 IUPnPRegistrar インターフェイスを使用して登録されます。 実行中のデバイスを登録できるのは管理者のみです。 実行中のデバイス コントロール オブジェクトを持つデバイスを登録するには、アプリケーションで IUPnPRegistrar::RegisterRunningDevice を呼び出し、次を渡す必要があります。

  • デバイスの説明のテキスト。
  • デバイス コントロール オブジェクトへの IUnknown ポインター。
  • デバイス コントロール オブジェクトの IUPnPDeviceControl::Initialize メソッドに渡される初期化文字列。
  • リソース ディレクトリの場所。
  • デバイスの有効期間。
  • この呼び出しの戻り値である Device ID パラメーター (OUT パラメーター)。デバイス ID へのポインターが C++ で返されます。

実行されていないデバイスの登録

既定では、管理者と対話型ユーザーのみが実行されていないデバイスを登録できます。 実行されていないデバイス コントロール オブジェクトにデバイスを登録するために、アプリケーションは IUPnPRegistrar::RegisterDevice メソッドを使用します。

実行中ではないデバイス コントロール オブジェクトにデバイスをプログラムで登録するには、アプリケーションで IUPnPRegistrar::RegisterDevice を呼び出し、次のパラメーターを渡す必要があります。

  • デバイスの説明のテキスト。
  • デバイス コントロール オブジェクトの ProgID。
  • デバイス コントロール オブジェクトの IUPnPDeviceControl::Initialize メソッドに渡される初期化文字列。
  • コンテナー ID。
  • リソース ディレクトリの場所。
  • デバイスの有効期間。
  • この呼び出しの戻り値である Device ID パラメーター (OUT パラメーター)。デバイス ID へのポインターが C++ で返されます。

実行中でないデバイスの登録は、システムの起動時に保持するように構成できます (デバイスはシャットダウン フェーズ中に発行されません)。 したがって、このように構成されている場合、コンピューターが起動されるたびにデバイスが発行され、発表されます。