Compartir a través de

Método IPNPXDeviceAssociation::Associate (pnpxassoc.h)

  • Artículo

[Detección de funciones está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.

Marca una entrada de base de datos de asociación como asociada y envía una notificación adecuada. Si no hay ninguna entrada de base de datos de asociación para la instancia de función, se crea una; de lo contrario, se actualiza la entrada existente. Cualquier notificación enviada refleja la presencia en línea del dispositivo, según lo notificado por el componente Plug and Play (PnP).

Sintaxis

HRESULT Associate(
  [in, optional] const WCHAR                    *pszSubCategory,
  [in]           IFunctionDiscoveryNotification *pIFunctionDiscoveryNotification
);

Parámetros

[in, optional] pszSubCategory

Subcategoría de la base de datos de asociación en la que se almacena la entrada. Este parámetro puede ser NULL.

[in] pIFunctionDiscoveryNotification

Objeto IFunctionDiscoveryNotification que está registrado para las notificaciones con detección de funciones.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
E_FAIL
 Error en el método.

Comentarios

Este método modifica la entrada de la base de datos de asociación correspondiente a la instancia de función desde la que se obtuvo la interfaz IPNPXDeviceAssociation .

Una vez asociado un dispositivo, el enumerador de IP Bus de servicio PnP-X (IPBusEnum) envía una solicitud al componente PnP para crear el devnode del dispositivo. Una vez creado el devnode, se envía la notificación adecuada. La siguiente lógica se usa para determinar el método de devolución de llamada que se usa para la notificación:

  • Si se recibe una notificación PnP después de asociar el dispositivo, se llama al método IFunctionDiscoveryNotification::OnUpdate con el parámetro enumQueryUpdateAction establecido en QUA_ADD.
  • Si no se recibe ninguna notificación PnP después de asociar el dispositivo y no hay eventos PnP pendientes, se llama al método IFunctionDiscoveryNotification::OnError .
  • Por último, si no se recibe ninguna notificación PnP después de asociar el dispositivo y hay eventos PnP pendientes, no se llama a ningún método de devolución de llamada.
Aparece el Asistente para nuevo hardware encontrado si se requiere intervención del usuario para instalar un controlador de dispositivo después de la asociación.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado pnpxassoc.h

Consulte también

IPNPXAssociation::Associate

IPNPXDeviceAssociation