Interfaccia IControlChangeNotify (devicetopology.h)

  • Articolo

L'interfaccia IControlChangeNotify fornisce notifiche quando cambia lo stato di una parte (connettore o subunit). A differenza delle altre interfacce di questa sezione, implementate dall'API DeviceTopology, l'interfaccia IControlChangeNotify deve essere implementata da un client. Per ricevere notifiche, il client passa un puntatore all'istanza dell'interfaccia IControlChangeNotify come parametro del metodo IPart::RegisterControlChangeCallback .

Dopo aver registrato l'interfaccia IControlChangeNotify , il client riceve le notifiche degli eventi sotto forma di callback tramite il metodo OnNotify nell'interfaccia.

Nell'implementazione dell'interfaccia IControlChangeNotify , il client deve osservare queste regole per evitare deadlock e comportamenti non definiti:

  • I metodi nell'interfaccia devono essere non bloccanti. Il client non deve mai attendere su un oggetto di sincronizzazione durante un callback di eventi.
  • Il client non deve mai chiamare il metodo IPart::UnregisterControlChangeCallback durante un callback di eventi.
  • Il client non deve mai rilasciare il riferimento finale su un oggetto API MMDevice durante un callback di eventi.

Ereditarietà

L'interfaccia IControlChangeNotify eredita dall'interfaccia IUnknown . IControlChangeNotify include anche questi tipi di membri:

Metodi

L'interfaccia IControlChangeNotify include questi metodi.

 
IControlChangeNotify::OnNotify

Il metodo OnNotify notifica al client quando lo stato di un connettore o di una subunit cambia.

Requisiti

   
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione devicetopology.h

Vedi anche

Interfacce audio di base

DeviceTopology API

IPart::RegisterControlChangeCallback

IPart::UnregisterControlChangeCallback