h6. [[SoundControl]] h6(. » [[SoundControl SWI Calls|SWI Calls]] h6((. » SoundCtrl_ExamineMixer h2. SoundCtrl_ExamineMixer h5. (SWI &50000) |_<^{width:4em}. Entry | | |<^. R0 |<^. Mixer system | |<^. R1 |<^. Pointer to word-aligned buffer for result | |<^. R2 |<^. Buffer size (may be 0) | |_<^{width:4em}. Exit | | |<^. R1 |<^. Buffer filled with as many [[SoundCtrl_ExamineMixer Block|blocks]] as possible | |<^. R2 |<^. Decremented by number of bytes needed for complete description | |<^. R3 |<^. Individual block size (bytes) - will be a multiple of 4 | |<^. R4 |<^. Number of blocks placed in buffer | h4. Use This SWI is used to read the features of a given mixer. If R2 is negative on exit, then the supplied buffer was too small to contain the full description and should be resized. h4. Notes R0 can either be a pointer to a null/control-terminated audio controller device ID string (as returned by [[Sound_EnumerateControllers]] or 0 (NULL) to refer to the mixer for the current default controller. Other SoundControl APIs such as [[SoundCtrl_SetMix]] use _category_ and _index_ parameters to identify each mixer channel, but the blocks that are placed within the buffer only indicate the category. The index of a given channel can be determined by looking at how many channels with the same category occur before it; for any given category, the first block in the buffer with that category is index 0, the second block with that category is index 1, etc. h4. See also * [[SoundCtrl_GetMix]] * [[SoundCtrl_SetMix]] * [[Sound_EnumerateControllers]]