Método IControlChangeNotify::OnNotify (devicetopology.h)

  • Artículo

El método OnNotify notifica al cliente cuando cambia el estado de un conector o subunidad.

Sintaxis

HRESULT OnNotify(
  [in] DWORD   dwSenderProcessId,
  [in] LPCGUID pguidEventContext
);

Parámetros

[in] dwSenderProcessId

Identificador de proceso del cliente que cambió el estado del control. Si un evento de hardware genera una notificación, este identificador de proceso diferirá del identificador de proceso del cliente. Para obtener más información, vea la sección Comentarios.

[in] pguidEventContext

Puntero al GUID de contexto para el evento de cambio de control. El cliente que inicia el cambio de control proporciona este GUID. Para obtener más información, vea la sección Comentarios.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, devuelve un código de error.

Comentarios

Un cliente puede usar este método para realizar un seguimiento de los cambios de control realizados por otros procesos y por el hardware. Sin embargo, un cliente que cambia una configuración de control normalmente puede ignorar la notificación de que el cambio de control genera. En su implementación del método OnNotify , un cliente puede inspeccionar los parámetros dwSenderProcessId y pguidEventContext para detectar si es u otro cliente el origen del evento de cambio de control.

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 devicetopology.h

Consulte también

IControlChangeNotify (Interfaz)