IAudioChannelConfig::SetChannelConfig method (devicetopology.h)

The SetChannelConfig method sets the channel-configuration mask in a channel-configuration control.


HRESULT SetChannelConfig(
  [in] DWORD   dwConfig,
  [in] LPCGUID pguidEventContext


[in] dwConfig

The channel-configuration mask.

[in] pguidEventContext

Context value for the IControlChangeNotify::OnNotify method. This parameter points to an event-context GUID. If the SetChannelConfig call changes the state of the channel-configuration control, all clients that have registered IControlChangeNotify interfaces with that control receive notifications. In its implementation of the OnNotify method, a client can inspect the event-context GUID to discover whether it or another client is the source of the control-change event. If the caller supplies a NULL pointer for this parameter, the client's notification method receives a NULL context pointer.

Return value

If the method succeeds, it returns S_OK. If it fails, possible return codes include, but are not limited to, the values shown in the following table.

Return code Description
Out of memory.


For information about channel-configuration masks, see the discussion of the KSPROPERTY_AUDIO_CHANNEL_CONFIG property in the Windows DDK documentation.


Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header devicetopology.h

See also

IAudioChannelConfig Interface