Interfaz IControlChangeNotify (devicetopology.h)

  • Artículo

La interfaz IControlChangeNotify proporciona notificaciones cuando cambia el estado de una parte (conector o subbúnit). A diferencia de las demás interfaces de esta sección, implementadas por la API DeviceTopology, la interfaz IControlChangeNotify debe implementarse mediante un cliente. Para recibir notificaciones, el cliente pasa un puntero a su instancia de interfaz IControlChangeNotify como parámetro al método IPart::RegisterControlChangeCallback .

Después de registrar su interfaz IControlChangeNotify , el cliente recibe notificaciones de eventos en forma de devoluciones de llamada a través del método OnNotify en la interfaz.

Al implementar la interfaz IControlChangeNotify , el cliente debe observar estas reglas para evitar interbloqueos y un comportamiento indefinido:

  • Los métodos de la interfaz deben no bloquearse. El cliente nunca debe esperar en un objeto de sincronización durante una devolución de llamada de evento.
  • El cliente nunca debe llamar al método IPart::UnregisterControlChangeCallback durante una devolución de llamada de evento.
  • El cliente nunca debe liberar la referencia final en un objeto de API MMDevice durante una devolución de llamada de evento.

Herencia

La interfaz IControlChangeNotify hereda de la interfaz IUnknown . IControlChangeNotify también tiene estos tipos de miembros:

Métodos

La interfaz IControlChangeNotify tiene estos métodos.

 
IControlChangeNotify::OnNotify

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

Requisitos

   
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

Interfaces de audio principales

DeviceTopology API

IPart::RegisterControlChangeCallback

IPart::UnregisterControlChangeCallback