AUDIO_VOLUME_NOTIFICATION_DATA 構造体 (endpointvolume.h)

[アーティクル]
08/23/2023

AUDIO_VOLUME_NOTIFICATION_DATA構造体では、オーディオエンドポイントデバイスのボリュームレベルまたはミュート状態の変更について説明します。

構文

typedef struct AUDIO_VOLUME_NOTIFICATION_DATA {
  GUID  guidEventContext;
  BOOL  bMuted;
  float fMasterVolume;
  UINT  nChannels;
  float afChannelVolumes[1];
} AUDIO_VOLUME_NOTIFICATION_DATA, *PAUDIO_VOLUME_NOTIFICATION_DATA;

メンバー

guidEventContext

IAudioEndpointVolumeCallback::OnNotify メソッドのコンテキスト値。このメンバーは、エンドポイントボリュームレベルまたはミュート状態を変更した IAudioEndpointVolume メソッド呼び出しへの入力パラメーターとして指定されたイベントコンテキスト GUID の値です。詳細については、「解説」を参照してください。

bMuted

オーディオストリームが現在ミュートされているかどうかを指定します。 bMuted が TRUE の場合、ストリームはミュートされます。 FALSE の場合、ストリームはミュートされません。

fMasterVolume

オーディオストリームの現在のマスターボリュームレベルを指定します。ボリュームレベルは 0.0 から 1.0 の範囲に正規化されます。ここで、0.0 は最小ボリュームレベル、1.0 は最大レベルです。この範囲内では、正規化されたボリュームレベルと信号振幅の減衰の関係は、非線形のオーディオテーパ曲線によって記述されます。オーディオテーパの詳細については、「 Audio-Tapered Volume Controls」を参照してください。

nChannels

オーディオストリーム内のチャネルの数を指定します。これは afChannelVolumes 配列内の要素の数でもあります。オーディオストリームに n 個のチャネルが含まれている場合、チャネルには 0 ~ n-1 の番号が付きます。特定のチャネルのボリュームレベルは、インデックスがチャネル番号と一致する配列要素に含まれています。

afChannelVolumes[1]

チャネルボリュームの配列内の最初の要素。この要素には、オーディオストリーム内のチャネル 0 の現在のボリュームレベルが含まれています。オーディオストリームに複数のチャネルが含まれている場合、追加チャネルのボリュームレベルは 、すぐにAUDIO_VOLUME_NOTIFICATION_DATA 構造に従います。各チャネルのボリュームレベルは、0.0 から 1.0 の範囲に正規化されます。ここで、0.0 は最小ボリュームレベル、1.0 は最大レベルです。この範囲内では、正規化されたボリュームレベルと信号振幅の減衰の関係は、非線形のオーディオテーパ曲線によって記述されます。

注釈

この構造体は、 IAudioEndpointVolumeCallback::OnNotify メソッドによって使用されます。

クライアントは、エンドポイントデバイスのボリュームレベルまたはミュート状態が変更されたときに通知を受け取るために登録できます。このような変更は、次の方法で発生する可能性があります。

これらのメソッドの 1 つを呼び出すと、ボリューム変更イベント (つまり、ボリュームレベルまたはミュート状態の変更) が発生すると、メソッドは、それらを受信するために登録されているすべてのクライアントに通知を送信します。メソッドは、クライアントの IAudioEndpointVolumeCallback::OnNotify メソッドを呼び出してクライアントに通知します。 OnNotify 呼び出しを通じて、クライアントは変更を説明するAUDIO_VOLUME_NOTIFICATION_DATA構造体へのポインターを受け取ります。

上記の一覧の各メソッドは、イベントコンテキスト GUID へのポインターである pguidEventContext という名前の入力パラメーターを受け入れます。クライアントに通知を送信する前に、メソッドは、pguidEventContext が指すイベントコンテキスト GUID を、OnNotify メソッドを介してクライアントに提供するAUDIO_VOLUME_NOTIFICATION_DATA構造体の guidEventContext メンバーにコピーします。 pguidEventContext が NULL の場合、guidEventContext メンバーの値は GUID_NULL に設定されます。

OnNotify メソッドの実装では、クライアントはその呼び出しからイベントコンテキスト GUID を検査して、その呼び出しまたは別のクライアントがボリューム変更イベントのソースであるかどうかを検出できます。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ \| UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリ \| UWP アプリ]
Header	endpointvolume.h