SetGenericSelect

Previous  Top  Next

   SHORT error = SetGenericSelect (
            [in] SHORT destType,
            [in] SHORT sourceType,
            [in] SHORT select
            )

Description

This method sets the current on/off selection setting of a particular destination and source in the currently selected mixer. The selected parameter should be set to 1 if the source is to be selected (not muted) or 0 if the source is to be not selected (muted). On exit, the DestNumber, SourceNumber and ControlNumber properties are undefined.

This method identifies whether selection for a particular destination is controlled by individual mute controls for each source or a master multiplexer/mixer control, and acts accordingly. Note that if the destination is controlled by a multiplexer or mixer control, there is no master mute control.

Note: If the destination is controlled by a multiplexer, typically exactly one source must be selected, so selecting a source will deselect all other sources, and it is not possible to deselect all sources.

Parameters

destType

is the type of destination for which the setting. This can be a standard destination type (not MSSMIX_DEST_CURRENT) or one of the special values MSSMIX_DEST_GENERIC_PLAYBACK or MSSMIX_DEST_GENERIC_RECORD. In the case of these two generic types, a destination that best fits the type is selected.

sourceType

is the type of source for which the volume is required. This should be a standard source type (not MSSMIX_SOURCE_CURRENT).

select

must be set to 1 to select (un-mute) the source, or 0 to de-select (mute) it.

Return value

The return value is MSSMERR_NOERROR (0) if the method succeeds, otherwise the value returned indicates an error.