Развернуть Свернуть

KSPROPERTY_AUDIO_VOLUMELEVEL

The KSPROPERTY_AUDIO_VOLUMELEVEL property specifies the volume level of a channel in a volume node (KSNODETYPE_VOLUME).

Usage Summary Table

GetSetTargetProperty descriptor typeProperty value type

Yes

Yes

Node via Filter or Pin instance

KSNODEPROPERTY_AUDIO_CHANNEL

LONG

 

The property value is of type LONG and specifies the volume level of a channel in a given stream. Volume-level values use the following scale:

-2147483648 is -infinity decibels (attenuation),

-2147483647 is -32767.99998474 decibels (attenuation), and

+2147483647 is +32767.99998474 decibels (gain).

Note  The decibel range is represented by integer values from -2147483648 to +2147483647, where this scale has a resolution of 1/65536 decibel.

If a value is specified beyond the range of the filter, the request to set this property will still be successful. But the actual value that was applied to the filter can only be determined by a subsequent Get call to this property.

Return Value

A KSPROPERTY_AUDIO_VOLUMELEVEL property request returns STATUS_SUCCESS to indicate that it has completed successfully. Otherwise, the request returns an appropriate error status code.

Remarks

The property descriptor for this property specifies a channel number. If the stream that passes through the volume node contains n channels, the channels are numbered 0 through n-1. For more information, see Exposing Multichannel Nodes.

Requirements

Header

Ksmedia.h (include Ksmedia.h)

See also

Customizing Default Audio Volume Settings
Default Audio Volume Settings
KSNODEPROPERTY_AUDIO_CHANNEL
KSNODETYPE_VOLUME

 

 

Send comments about this topic to Microsoft

Показ:
© 2014 Microsoft