+/**
+ * glk_schannel_play_ext:
+ * @chan: Channel to play the sound in.
+ * @snd: Resource number of the sound to play.
+ * @repeats: Number of times to repeat the sound.
+ * @notify: If nonzero, requests a notification when the sound is finished.
+ *
+ * This works the same as glk_schannel_play(), but lets you specify additional
+ * options. <code>glk_schannel_play(chan, snd)</code> is exactly equivalent to
+ * <code>glk_schannel_play_ext(chan, snd, 1, 0)</code>.
+ *
+ * The @repeats value is the number of times the sound should be repeated. A
+ * repeat value of -1 (or rather 0xFFFFFFFF) means that the sound should repeat
+ * forever. A repeat value of 0 means that the sound will not be played at all;
+ * nothing happens. (Although a previous sound on the channel will be stopped,
+ * and the function will return 1.)
+ *
+ * The @notify value should be nonzero in order to request a sound notification
+ * event. If you do this, when the sound is completed, you will get an event
+ * with type %evtype_SoundNotify. The @window will be %NULL, @val1 will be the
+ * sound's resource id, and @val2 will be the nonzero value you passed as
+ * @notify.
+ *
+ * If you request sound notification, and the repeat value is greater than one,
+ * you will get the event only after the last repetition. If the repeat value is
+ * 0 or -1, you will never get a notification event at all. Similarly, if the
+ * sound is stopped or interrupted, or if the channel is destroyed while the
+ * sound is playing, there will be no notification event.
+ *
+ * Not all libraries support sound notification. You should test the
+ * %gestalt_SoundNotify selector before you rely on it; see <link
+ * linkend="chimara-Testing-for-Sound-Capabilities">Testing for Sound
+ * Capabilities</link>.
+ *
+ * <warning><para>This function is not implemented yet.</para></warning>
+ *
+ * Returns: 1 on success, 0 on failure.
+ */