Método IMMNotificationClient::OnPropertyValueChanged (mmdeviceapi.h)
O método OnPropertyValueChanged indica que o valor de uma propriedade pertencente a um dispositivo de ponto de extremidade de áudio foi alterado.
Sintaxe
HRESULT OnPropertyValueChanged(
[in] LPCWSTR pwstrDeviceId,
[in] const PROPERTYKEY key
);
Parâmetros
[in] pwstrDeviceId
Ponteiro para a cadeia de caracteres de ID do ponto de extremidade que identifica o dispositivo de ponto de extremidade de áudio. Esse parâmetro aponta para uma cadeia de caracteres largos terminada em nulo que contém a ID do ponto de extremidade. A cadeia de caracteres permanece válida durante a chamada.
[in] key
Uma estrutura PROPERTYKEY que especifica a propriedade . A estrutura contém o GUID do conjunto de propriedades e um índice que identifica uma propriedade dentro do conjunto. A estrutura é passada por valor. Ele permanece válido durante a chamada. Para obter mais informações sobre PROPERTYKEY, consulte a documentação do SDK do Windows.
Retornar valor
Se o método for bem-sucedido, retornará S_OK. Se falhar, retornará um código de erro.
Comentários
Uma chamada para o método IPropertyStore::SetValue que altera com êxito o valor de uma propriedade de um dispositivo de ponto de extremidade de áudio gera uma chamada para OnPropertyValueChanged. Para obter mais informações sobre IPropertyStore::SetValue, consulte a documentação do SDK do Windows.
Um cliente pode usar o parâmetro key para recuperar o novo valor da propriedade. Para obter um exemplo de código que usa uma chave de propriedade para recuperar um valor de propriedade do repositório de propriedades de um dispositivo de ponto de extremidade, consulte Propriedades do dispositivo.
Para obter um exemplo de código que implementa o método OnPropertyValueChanged , consulte Eventos de dispositivo.
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 | mmdeviceapi.h |