Compartir a través de


Cómo registrar un dispositivo con el host de dispositivo

Puede registrar un dispositivo en ejecución o un dispositivo que no se esté ejecutando.

Registro de un dispositivo en ejecución

Los dispositivos se registran mediante la interfaz IUPnPRegistrar . Solo los administradores pueden registrar dispositivos en ejecución. Para registrar un dispositivo que tiene un objeto de control de dispositivo en ejecución, una aplicación debe invocar IUPnPRegistrar::RegisterRunningDevice, pasando lo siguiente:

  • Texto de la descripción del dispositivo.
  • Puntero IUnknown al objeto de control de dispositivo.
  • Cadena de inicialización que se pasa al método IUPnPDeviceControl::Initialize del objeto de control de dispositivo.
  • Ubicación del directorio de recursos.
  • Duración del dispositivo.
  • El parámetro Id. de dispositivo (un parámetro OUT), que es el valor devuelto de esta llamada; Se devuelve un puntero al identificador de dispositivo en C++.

Registro de un dispositivo no en ejecución

De forma predeterminada, solo los administradores y los usuarios interactivos pueden registrar dispositivos no en ejecución. Para registrar un dispositivo con un objeto de control de dispositivo que no se está ejecutando, la aplicación usa el método IUPnPRegistrar::RegisterDevice .

Para registrar mediante programación un dispositivo con un objeto de control de dispositivo no en ejecución, la aplicación debe invocar IUPnPRegistrar::RegisterDevice y pasarla los parámetros siguientes:

  • Texto de la descripción del dispositivo.
  • ProgID del objeto de control de dispositivo.
  • Cadena de inicialización que se pasa al método IUPnPDeviceControl::Initialize del objeto de control de dispositivo.
  • Un identificador de contenedor.
  • Ubicación del directorio de recursos.
  • Duración del dispositivo.
  • El parámetro Id. de dispositivo (un parámetro OUT), que es el valor devuelto de esta llamada; Se devuelve un puntero al identificador de dispositivo en C++.

Los registros de dispositivos que no están en ejecución se pueden configurar para conservarse en los arranques del sistema (los dispositivos no se han publicado durante la fase de apagado). Por lo tanto, si se configuran de esta manera, los dispositivos se publican y anuncian cada vez que se arranca el equipo.