IMMNotificationClient::OnPropertyValueChanged メソッド (mmdeviceapi.h)
OnPropertyValueChanged メソッドは、オーディオ エンドポイント デバイスに属するプロパティの値が変更されたことを示します。
構文
HRESULT OnPropertyValueChanged(
[in] LPCWSTR pwstrDeviceId,
[in] const PROPERTYKEY key
);
パラメーター
[in] pwstrDeviceId
オーディオ エンドポイント デバイスを識別する エンドポイント ID 文字列 へのポインター。 このパラメーターは、エンドポイント ID を含む null で終わるワイド文字列を指します。 この文字列は、呼び出しの間有効なままです。
[in] key
プロパティを指定する PROPERTYKEY 構造体。 構造体には、プロパティ セット GUID と、セット内のプロパティを識別するインデックスが含まれています。 構造体は値渡しされます。 呼び出しの間は有効なままです。 PROPERTYKEY の詳細については、Windows SDKドキュメントを参照してください。
戻り値
メソッドが成功した場合は、S_OK を返します。 失敗した場合はエラー コードを返します。
解説
オーディオ エンドポイント デバイスのプロパティの値を正常に変更する IPropertyStore::SetValue メソッドを呼び出すと、 OnPropertyValueChanged への呼び出しが生成されます。 IPropertyStore::SetValue の詳細については、Windows SDKドキュメントを参照してください。
クライアントは 、key パラメーターを使用して新しいプロパティ値を取得できます。 プロパティ キーを使用してエンドポイント デバイスのプロパティ ストアからプロパティ値を取得するコード例については、「 Device Properties」を参照してください。
OnPropertyValueChanged メソッドを実装するコード例については、「デバイス イベント」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | mmdeviceapi.h |