SetGenericSelectAll

Previous  Top  Next

   SHORT error = SetGenericSelectAll (
            [in] SHORT destType,
            [in] SHORT select
            )

Description

This method sets the current on/off selection setting for all sources associated with a particular destination. The selected parameter should be set to 1 if the sources are to be selected (not muted) or 0 if the sources are 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 that, if the destination has a master mute control, this is unaffected by this function.

Also, if the destination is controlled by a multiplexer, typically exactly one source must be selected, so this method will always fail in this case (unless the destination only has one source).

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.

select

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

Return value

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