IAMTVAudio interface (strmif.h)
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The IAMTVAudio interface controls audio from a television source. The TV Audio filter implements this interface. Applications can use it to control television audio settings, including secondary audio program (SAP) and stereo or mono selection.
Inheritance
The IAMTVAudio interface inherits from the IUnknown interface. IAMTVAudio also has these types of members:
Methods
The IAMTVAudio interface has these methods.
| IAMTVAudio::get_TVAudioMode The get_TVAudioMode method retrieves the current TV audio mode. |
| IAMTVAudio::GetAvailableTVAudioModes The GetAvailableTVAudioModes method retrieves a bitmask of the possible modes. |
| IAMTVAudio::GetHardwareSupportedTVAudioModes The GetHardwareSupportedTVAudioModes method retrieves a bitmask of the formats available in the hardware. |
| IAMTVAudio::put_TVAudioMode The put_TVAudioMode method sets the current TV audio mode. |
| IAMTVAudio::RegisterNotificationCallBack The RegisterNotificationCallBack method enables an object that implements the IAMTunerNotification interface to receive event notifications when the tuner changes state. |
| IAMTVAudio::UnRegisterNotificationCallBack The UnRegisterNotificationCallBack method unregisters an object for event notifications. (IAMTVAudio.UnRegisterNotificationCallBack) |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | strmif.h (include Dshow.h) |