Metodo IMMNotificationClient::OnPropertyValueChanged (mmdeviceapi.h)

Il metodo OnPropertyValueChanged indica che il valore di una proprietà appartenente a un dispositivo endpoint audio è cambiato.

Sintassi

HRESULT OnPropertyValueChanged(
  [in] LPCWSTR           pwstrDeviceId,
  [in] const PROPERTYKEY key
);

Parametri

[in] pwstrDeviceId

Puntatore alla stringa ID dell'endpoint che identifica il dispositivo dell'endpoint audio. Questo parametro punta a una stringa di caratteri wide con terminazione null che contiene l'ID dell'endpoint. La stringa rimane valida per la durata della chiamata.

[in] key

Struttura PROPERTYKEY che specifica la proprietà. La struttura contiene il GUID set di proprietà e un indice che identifica una proprietà all'interno del set. La struttura viene passata per valore. Rimane valido per la durata della chiamata. Per altre informazioni su PROPERTYKEY, vedere la documentazione di Windows SDK.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, viene restituito un codice di errore.

Commenti

Una chiamata al metodo IPropertyStore::SetValue che modifica correttamente il valore di una proprietà di un dispositivo endpoint audio genera una chiamata a OnPropertyValueChanged. Per altre informazioni su IPropertyStore::SetValue, vedere la documentazione di Windows SDK.

Un client può usare il parametro chiave per recuperare il nuovo valore della proprietà. Per un esempio di codice che usa una chiave di proprietà per recuperare un valore della proprietà dall'archivio delle proprietà di un dispositivo endpoint, vedere Proprietà dispositivo.

Per un esempio di codice che implementa il metodo OnPropertyValueChanged , vedere Eventi dispositivo.

Requisiti

Vedi anche

Interfaccia IMMNotificationClient