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