BASS

BASS_ChannelGetAttributeEx


Retrieves the value of a channel's attribute.

DWORD BASS_ChannelGetAttributeEx(
    DWORD handle,
    DWORD attrib,
    void *value,
    DWORD size
);

Parameters

handleThe channel handle... a HCHANNEL, HMUSIC, HSTREAM, or HRECORD.
attribThe attribute to get the value of... one of the following.
BASS_ATTRIB_SCANINFOScanned info. (HSTREAM only)
other attributes may be supported by add-ons, see the documentation.
valuePointer to a buffer to receive the attribute data.
sizeThe size of the attribute data... 0 = get the size of the attribute without getting the data.

Return value

If successful, the size of the attribute data is returned, else 0 is returned. Use BASS_ErrorGetCode to get the error code.

Error codes

BASS_ERROR_HANDLEhandle is not a valid channel.
BASS_ERROR_NOTAVAILThe attribute is not available.
BASS_ERROR_ILLTYPEattrib is not valid.
BASS_ERROR_ILLPARAMsize is not valid.
some attributes may have additional error codes, see the documentation.

Remarks

This function also supports the floating-point attributes supported by BASS_ChannelGetAttribute.

See also

BASS_ChannelGetAttribute, BASS_ChannelGetInfo, BASS_ChannelSetAttributeEx