Método IControlChangeNotify::OnNotify (devicetopology.h)
O método OnNotify notifica o cliente quando o status de um conector ou subunidade é alterado.
Sintaxe
HRESULT OnNotify(
[in] DWORD dwSenderProcessId,
[in] LPCGUID pguidEventContext
);
Parâmetros
[in] dwSenderProcessId
A ID do processo do cliente que alterou o estado do controle. Se uma notificação for gerada por um evento de hardware, essa ID de processo será diferente da ID do processo do cliente. Para obter mais informações, consulte Comentários.
[in] pguidEventContext
Um ponteiro para o GUID de contexto para o evento control-change. O cliente que inicia a alteração de controle fornece esse GUID. Para obter mais informações, consulte Comentários.
Retornar valor
Se o método for bem-sucedido, retornará S_OK. Se falhar, retornará um código de erro.
Comentários
Um cliente pode usar esse método para controlar as alterações de controle feitas por outros processos e pelo hardware. No entanto, um cliente que altera uma configuração de controle normalmente pode ignorar a notificação gerada pela alteração de controle. Em sua implementação do método OnNotify , um cliente pode inspecionar os parâmetros dwSenderProcessId e pguidEventContext para descobrir se ele ou outro cliente é a origem do evento control-change.
Requisitos
| Requisito | Valor |
|---|---|
| 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 |