Compartir a través de


Método IUPnPDeviceControl::Initialize (upnphost.h)

El método Initialize se usa para inicializar el dispositivo. El host del dispositivo invoca este método.

Sintaxis

HRESULT Initialize(
  [in] BSTR bstrXMLDesc,
  [in] BSTR bstrDeviceIdentifier,
  [in] BSTR bstrInitString
);

Parámetros

[in] bstrXMLDesc

Especifica la descripción completa del dispositivo XML, según lo publicado por el host del dispositivo. La descripción del dispositivo se basa en la plantilla proporcionada por el dispositivo.

[in] bstrDeviceIdentifier

Identifica el dispositivo que se va a inicializar. Este es el mismo identificador devuelto por IUPnPRegistrar::RegisterDevice o IUPnPRegistrar::RegisterRunningDevice. También se usa para recuperar el UDN del dispositivo mediante IUPnPRegistrar::GetUniqueDeviceName.

[in] bstrInitString

Especifica la cadena de inicialización usada cuando se registró este dispositivo.

Valor devuelto

Al implementar este método, devuelva S_OK si el método se realiza correctamente. De lo contrario, devuelve uno de los códigos de error COM definidos en WinError.h.

Comentarios

Este método se invoca inmediatamente después de crear una instancia del objeto de control de dispositivo. Se debe invocar antes de que se invoque IUPnPDeviceControl::GetServiceObject .

La diferencia entre un dispositivo en ejecución y un dispositivo que no se está ejecutando es cuando se invoca el método Initialize .

Para los dispositivos en ejecución, initialize se invoca cuando se invoca IUPnPRegistrar::RegisterRunningDevice y la inicialización se completa antes de que se devuelva IUPnPRegistrar::RegisterRunningDevice .

En el caso de los dispositivos que no se ejecutan, Initialize no se invoca necesariamente cuando se invoca IUPnPRegistrar::RegisterDevice . La inicialización se invoca cuando llega el primer control o solicitud de evento.

El bstrDeviceIdentifier también se puede usar para llamar a IUPnPRegistrar::GetUniqueDeviceName.

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado upnphost.h
Archivo DLL Upnphost.dll

Consulte también

GetServiceObject

IUPnPDeviceControl