Edit

AUDIO_VOLUME_NOTIFICATION_DATA2 structure (audioengineextensionapo.h)

  • Article

Represents information about a volume change notification event. This structure is used by the AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION2 structure.

Syntax

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;

Members

notificationData

An AUDIO_VOLUME_NOTIFICATION_DATA structure containing additional information about the volume change event.

masterVolumeInDb

A float value representing the current master volume level of the audio stream in dB.

volumeMinInDb

A float value representing the minimum volume level of the endpoint in decibels. This value remains constant for the lifetime of the audio device specified in the associated AUDIO_ENDPOINT_VOLUME_APO_NOTIFICATION_DESCRIPTOR.

volumeMaxInDb

A float value representing the maximum volume level of the endpoint in decibels. This value remains constant for the lifetime of the audio device specified in the associated AUDIO_ENDPOINT_VOLUME_APO_NOTIFICATION_DESCRIPTOR.

volumeIncrementInDb

A float value representing the volume increment of the endpoint in decibels. This value remains constant for the lifetime of the audio device specified in the associated AUDIO_ENDPOINT_VOLUME_APO_NOTIFICATION_DESCRIPTOR.

step

An unsigned integer value representing the current step in the volume range. Is a value in the range from 0 to stepCount - 1, where 0 represents the minimum volume level and stepCount - 1 represents the maximum level.

stepCount

An unsigned integer value representing the number of steps in the volume range. This value remains constant for the lifetime of the audio device specified in the associated AUDIO_ENDPOINT_VOLUME_APO_NOTIFICATION_DESCRIPTOR.

channelVolumesInDb[1]

The first element in an array of channel volumes in dB. This element contains the current volume level of channel 0 in the audio stream. If the audio stream contains more than one channel, the volume levels for the additional channels immediately follow the AUDIO_VOLUME_NOTIFICATION_DATA2 structure.

Requirements

Requirement Value
Header audioengineextensionapo.h