KSNODETYPE_PEAKMETER

The KSNODETYPE_PEAKMETER node represents a hardware peakmeter. A KS peakmeter node has one input pin and one output pin, and the two pins share the same data format.

A KS peakmeter internally logs the maximum value of the audio signal since the last time the peakmeter was reset to zero. The peakmeter automatically resets itself to zero after an IOCTL_KS_PROPERTY request to get a KSPROPERTY_AUDIO_PEAKMETER property.

A peakmeter requires hardware support. A software peakmeter is not feasible, and this is because the adapter driver does not have access to signals that are present on line-in, microphone, or other inputs that are mixed with the playback channel.

Microsoft recommends making a peakmeter node the final node through which a stream passes within a filter. On a render stream, an audio adapter usually connects a peakmeter node after a master output KSNODETYPE_MUTE node or a KSNODETYPE_VOLUME node. The same approach applies to a capture stream or any other streams for which the filter incorporates a peakmeter node.

An audio adapter should name a peakmeter node KSAUDFNAME_PEAKMETER.

A peakmeter node should provide a property handler for the property flags (see KSPROPERTY) that appear in the following table.

Flag NameMeaning

KSPROPERTY_TYPE_GET

Returns the current value of the hardware peakmeter.

KSPROPERTY_TYPE_BASICSUPPORT

Returns a data range of -32768 to 32767, which is the data range of 16-bit digital audio.

 

The property handler should verify input parameters and left and right channel information.

A peakmeter node should also support the properties in the following table.

Property NameDescription

KSPROPERTY_AUDIO_PEAKMETER

Represents the peakmeter control.

KSPROPERTY_AUDIO_CPU_RESOURCES

Indicates whether the specified node's functionality makes use of the host CPU.

 

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft