Método IMMNotificationClient::OnPropertyValueChanged (mmdeviceapi.h)

  • Artículo

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

Consulte también

Interfaz IMMNotificationClient