# SND_UnlockChannel

## Syntax

      #include <nitro/snd.h>

      void SND_UnlockChannel( u32 chBitMask, u32 flags );

## Arguments

`chBitMask` | The channel bit mask. It specifies which channels to control.
`flags` | Option flags. At the current time the flags are not used, so 0 is entered here.

## Return Values

None.

## Description

Unlocks channels that were locked with the `SND_LockChannel` function.

The channel bit mask `chBitMask` specifies which channels to control. The channels are represented in order, with the lowest bit representing channel 0. Only channels whose representative bits are standing are controlled.

### Note

This function is an ARM7 reserved function. After this function is called, its processing will occur only after the command is issued with the `SND_FlushCommand` function.

If program execution must be synchronized with process completion, first use the `SND_GetCurrentCommandTag` function to obtain the command tag immediately after calling this function. Then, after the command is issued, use the command tag and call either the `SND_IsFinishedCommandTag` or `SND_WaitForCommandProc` function to confirm that processing has finished or to wait for it to complete.

## See Also

`SND_LockChannel, SND_FlushCommand, SND_GetCurrentCommandTag, SND_IsFinishedCommandTag, SND_WaitForCommandProc`

## Revision History

2005/02/17 Added a note about ARM7 command processing.
2004/10/21 Added a reference to the `SND_LockChannel` function.
2004/07/20 Initial version.

CONFIDENTIAL