AUDIO_VOLUME_NOTIFICATION_DATA2 結構 (audioengineextensionapo.h)

表示磁碟區變更通知事件的相關信息。 這個結構是由 AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION2 結構使用。

語法

typedef struct AUDIO_VOLUME_NOTIFICATION_DATA2 {
  PAUDIO_VOLUME_NOTIFICATION_DATA notificationData;
  float                           masterVolumeInDb;
  float                           volumeMinInDb;
  float                           volumeMaxInDb;
  float                           volumeIncrementInDb;
  UINT                            step;
  UINT                            stepCount;
  float                           channelVolumesInDb[1];
} AUDIO_VOLUME_NOTIFICATION_DATA2, *PAUDIO_VOLUME_NOTIFICATION_DATA2;

成員

notificationData

包含磁碟區變更事件的其他資訊 AUDIO_VOLUME_NOTIFICATION_DATA 結構。

masterVolumeInDb

浮點數,表示 dB 中音訊數據流目前的主要音量層級。

volumeMinInDb

浮點數,表示端點的最小磁碟區層級,以分貝為單位。 這個值會在相關聯 AUDIO_ENDPOINT_VOLUME_APO_NOTIFICATION_DESCRIPTOR中指定的音訊裝置存留期維持不變。

volumeMaxInDb

浮點數,表示端點的磁碟區層級上限,以減數表示。 這個值會在相關聯 AUDIO_ENDPOINT_VOLUME_APO_NOTIFICATION_DESCRIPTOR中指定的音訊裝置存留期維持不變。

volumeIncrementInDb

浮點數,表示端點的磁碟區遞增,以分貝為單位。 這個值會在相關聯 AUDIO_ENDPOINT_VOLUME_APO_NOTIFICATION_DESCRIPTOR中指定的音訊裝置存留期維持不變。

step

不帶正負號的整數值,代表磁碟區範圍內的目前步驟。 這是範圍從 0 到 stepCount - 1 的值,其中 0 代表最小磁碟區層級, 而 stepCount - 1 代表最大層級。

stepCount

不帶正負號的整數值,代表磁碟區範圍中的步驟數目。 這個值會在相關聯 AUDIO_ENDPOINT_VOLUME_APO_NOTIFICATION_DESCRIPTOR中指定的音訊裝置存留期維持不變。

channelVolumesInDb[1]

dB 中信道磁碟區陣列中的第一個專案。 這個專案包含音訊數據流中信道0的目前音量層級。 如果音訊數據流包含多個通道,其他通道的音量層級會緊接在 AUDIO_VOLUME_NOTIFICATION_DATA2 結構之後。

規格需求

需求
標頭 audioengineextensionapo.h