FindControl

Previous  Top  Next

   SHORT error = FindControl (
            [in] SHORT destType,
            [in] SHORT destTargetType,
            [in] SHORT sourceType,
            [in] SHORT sourceTargetType,
            [in] SHORT controlType
            )

Description

This method finds a control of a particular type in the currently selected mixer, setting the DestNumber, SourceNumber and ControlNumber properties to appropriate values. If the control is not found, these properties remain unchanged.

Parameters

destType

is the Destination Type to find. Use the special value MSSMIX_DEST_CURRENT to use the destination currently set in DestNumber. Use the value MSSMIX_DEST_IGNORE to select the destination from the specified destination target type only (see below). The generic types MSSMIX_DEST_GENERIC_* may not be used.

destTargetType

is the Destination Target Type to find. This is only used if destType is set to MSSMIX_DEST_IGNORE or if the destination type specified by destType is not found.

sourceType

is the Source Type to find. Use the special value MSSMIX_SOURCE_CURRENT to use the source currently set in SourceNumber (this may only be specified if destType is MSSMIX_DEST_CURRENT). Use the value MSSMIX_SOURCE_IGNORE to select the source from the specified source target type only (see below).

sourceTargetType

is the Source Target Type to find. This is only used if sourceType is set to MSSMIX_SOURCE_IGNORE or if the source type specified by sourceType is not found.

controlType

is the Control Type to find. This must be a control type, not a control class.

Return value

The return value is MSSMERR_NOERROR (0) if the control was found, otherwise the value returned indicates an error.