IAudioMute Interface

Previous Next

IAudioMute Interface

The IAudioMute interface provides access to a hardware mute control. The client obtains a reference to the IAudioMute interface of a subunit by calling the IPart::Activate method with parameter refiid set to REFIID IID_IAudioMute. The call to IPart::Activate succeeds only if the subunit supports the IAudioMute interface. Only a subunit object that represents a hardware mute control function will support this interface.

Most Windows audio adapter drivers support the Windows Driver Model (WDM) and use kernel-streaming (KS) properties to represent the hardware control parameters in subunits (referred to as KS nodes). The IAudioMute interface provides convenient access to the KSPROPERTY_AUDIO_MUTE property of a subunit that has a subtype GUID value of KSNODETYPE_MUTE. To obtain the subtype GUID of a subunit, call the IPart::GetSubType method. For more information about KS properties and KS node types, see the Windows DDK documentation.

IAudioMute inherits from the IUnknown interface. In addition to the methods inherited from IUnknown, IAudioMute supports the following methods.

Method Description
GetMute Gets the current state (enabled or disabled) of the mute control.
SetMute Enables or disables the mute control.

Requirements

Client: Windows Vista

Header: Include Devicetopology.h.

See Also

Previous Next