Método IMMNotificationClient::OnPropertyValueChanged (mmdeviceapi.h)
El método OnPropertyValueChanged indica que el valor de una propiedad que pertenece a un dispositivo de punto de conexión de audio ha cambiado.
Sintaxis
HRESULT OnPropertyValueChanged(
[in] LPCWSTR pwstrDeviceId,
[in] const PROPERTYKEY key
);
Parámetros
[in] pwstrDeviceId
Puntero a la cadena de identificador de punto de conexión que identifica el dispositivo de punto de conexión de audio. Este parámetro apunta a una cadena de caracteres anchos terminada en null que contiene el identificador del punto de conexión. La cadena sigue siendo válida durante la llamada.
[in] key
Estructura PROPERTYKEY que especifica la propiedad . La estructura contiene el GUID del conjunto de propiedades y un índice que identifica una propiedad dentro del conjunto. La estructura se pasa por valor. Sigue siendo válido durante la llamada. Para obtener más información sobre PROPERTYKEY, consulte la documentación de Windows SDK.
Valor devuelto
Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, devuelve un código de error.
Comentarios
Una llamada al método IPropertyStore::SetValue que cambia correctamente el valor de una propiedad de un dispositivo de punto de conexión de audio genera una llamada a OnPropertyValueChanged. Para obtener más información sobre IPropertyStore::SetValue, consulte la documentación de Windows SDK.
Un cliente puede usar el parámetro key para recuperar el nuevo valor de propiedad. Para obtener un ejemplo de código que usa una clave de propiedad para recuperar un valor de propiedad del almacén de propiedades de un dispositivo de punto de conexión, consulte Propiedades del dispositivo.
Para obtener un ejemplo de código que implemente el método OnPropertyValueChanged , consulte Eventos de dispositivo.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | mmdeviceapi.h |