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

こちらもご覧ください

IMMNotificationClient インターフェイス