Registrieren eines Geräts beim Gerätehost

  • Artikel

Sie können entweder ein ausgeführtes Gerät oder ein nicht ausgeführtes Gerät registrieren.

Registrieren eines ausgeführten Geräts

Geräte werden über die IUPnPRegistrar-Schnittstelle registriert. Nur Administratoren dürfen ausgeführte Geräte registrieren. Um ein Gerät zu registrieren, das über ein ausgeführtes Gerätesteuerungsobjekt verfügt, muss eine Anwendung IUPnPRegistrar::RegisterRunningDevice aufrufen und Folgendes übergeben:

  • Der Text der Gerätebeschreibung.
  • Ein IUnknown-Zeiger auf das Gerätesteuerungsobjekt.
  • Eine Initialisierungszeichenfolge, die an die IUPnPDeviceControl::Initialize-Methode des Gerätesteuerelementobjekts übergeben wird.
  • Der Speicherort des Ressourcenverzeichnisses.
  • Die Lebensdauer des Geräts.
  • Der Device ID-Parameter (ein OUT-Parameter), der der Rückgabewert dieses Aufrufs ist; Ein Zeiger auf die Geräte-ID wird in C++ zurückgegeben.

Registrieren eines nicht ausgeführten Geräts

Standardmäßig dürfen nur Administratoren und interaktive Benutzer nicht ausgeführte Geräte registrieren. Um ein Gerät mit einem Nicht ausgeführten Gerätesteuerungsobjekt zu registrieren, verwendet die Anwendung die IUPnPRegistrar::RegisterDevice-Methode .

Um ein Gerät mit einem nicht ausgeführten Gerätesteuerungsobjekt programmgesteuert zu registrieren, muss die Anwendung IUPnPRegistrar::RegisterDevice aufrufen und die folgenden Parameter übergeben:

  • Der Text der Gerätebeschreibung.
  • Die ProgID des Gerätesteuerungsobjekts.
  • Eine Initialisierungszeichenfolge, die an die IUPnPDeviceControl::Initialize-Methode des Gerätesteuerelementobjekts übergeben wird.
  • Eine Container-ID.
  • Der Speicherort des Ressourcenverzeichnisses.
  • Die Lebensdauer des Geräts.
  • Der Device ID-Parameter (ein OUT-Parameter), der der Rückgabewert dieses Aufrufs ist; Ein Zeiger auf die Geräte-ID wird in C++ zurückgegeben.

Die Registrierungen nicht ausgeführter Geräte können so konfiguriert werden, dass sie über systeminterne Startvorgänge beibehalten werden (die Geräte werden während der Herunterfahrensphase nicht veröffentlicht). Wenn sie auf diese Weise konfiguriert sind, werden geräte daher jedes Mal veröffentlicht und angekündigt, wenn der Computer gestartet wird.