Compartilhar via


Interface IControlChangeNotify (devicetopology.h)

A interface IControlChangeNotify fornece notificações quando o status de uma parte (conector ou subunidade) é alterado. Ao contrário das outras interfaces nesta seção, que são implementadas pela API DeviceTopology, a interface IControlChangeNotify deve ser implementada por um cliente. Para receber notificações, o cliente passa um ponteiro para sua instância de interface IControlChangeNotify como um parâmetro para o método IPart::RegisterControlChangeCallback .

Depois de registrar sua interface IControlChangeNotify , o cliente recebe notificações de evento na forma de retornos de chamada por meio do método OnNotify na interface .

Ao implementar a interface IControlChangeNotify , o cliente deve observar essas regras para evitar deadlocks e comportamento indefinido:

  • Os métodos na interface devem não ser desbloqueados. O cliente nunca deve aguardar um objeto de sincronização durante um retorno de chamada de evento.
  • O cliente nunca deve chamar o método IPart::UnregisterControlChangeCallback durante um retorno de chamada de evento.
  • O cliente nunca deve liberar a referência final em um objeto de API MMDevice durante um retorno de chamada de evento.

Herança

A interface IControlChangeNotify herda da interface IUnknown . IControlChangeNotify também tem estes tipos de membros:

Métodos

A interface IControlChangeNotify tem esses métodos.

 
IControlChangeNotify::OnNotify

O método OnNotify notifica o cliente quando o status de um conector ou subunidade é alterado.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho devicetopology.h

Confira também

Principais interfaces de áudio

DeviceTopology API

IPart::RegisterControlChangeCallback

IPart::UnregisterControlChangeCallback