639 * @return void |
639 * @return void |
640 */ |
640 */ |
641 IMPORT_C void PlayToneSequenceL(const TDesC8& aData); |
641 IMPORT_C void PlayToneSequenceL(const TDesC8& aData); |
642 |
642 |
643 /** |
643 /** |
644 * Initializes the audio device and starts playing the specified |
|
645 * pre-defined tone sequence. |
|
646 * Leaves on failure. |
|
647 * @since |
|
648 * @param TInt aSequenceNumber The index identifying the specific |
|
649 * pre-defined tone sequence. Index values are relative to zero. |
|
650 * This can be any value from zero to the value returned by a call |
|
651 * to FixedSequenceCount() - 1. The function raises a panic if the |
|
652 * sequence number is not within this range. |
|
653 * @return void |
|
654 */ |
|
655 IMPORT_C void PlayFixedSequenceL(TInt aSequenceNumber); |
|
656 |
|
657 /** |
|
658 * Defines the number of times the audio is to be repeated during the |
644 * Defines the number of times the audio is to be repeated during the |
659 * tone playback operation. A period of silence can follow each playing |
645 * tone playback operation. A period of silence can follow each playing |
660 * of a tone. The tone playing can be repeated indefinitely |
646 * of a tone. The tone playing can be repeated indefinitely |
661 * @since |
647 * @since |
662 * @param TInt aRepeatCount The number of times the tone, together with |
648 * @param TInt aRepeatCount The number of times the tone, together with |
724 * @return TAny* A pointer to the interface implementation, or NULL if |
710 * @return TAny* A pointer to the interface implementation, or NULL if |
725 * the device does not implement the interface requested. The |
711 * the device does not implement the interface requested. The |
726 * return value must be cast to the correct type by the user. |
712 * return value must be cast to the correct type by the user. |
727 */ |
713 */ |
728 IMPORT_C TAny* CustomInterface(TUid aInterfaceId); |
714 IMPORT_C TAny* CustomInterface(TUid aInterfaceId); |
729 |
|
730 /** |
|
731 * Returns the number of available pre-defined tone sequences. |
|
732 * This is the number of fixed sequence supported by DevSound by default. |
|
733 * @since |
|
734 * @return TInt The fixed sequence count. This value is implementation |
|
735 * dependent. |
|
736 */ |
|
737 IMPORT_C TInt FixedSequenceCount(); |
|
738 |
|
739 /** |
|
740 * Returns the name assigned to a specific pre-defined tone sequence. |
|
741 * This is the number of the fixed sequence supported by DevSound by |
|
742 * default. |
|
743 * The function raises a panic if sequence number specified is invalid. |
|
744 * @since |
|
745 * @param TInt aSequenceNumber The index identifying the specific |
|
746 * pre-defined tone sequence. Index values are relative to zero. |
|
747 * This can be any value from zero to the value returned by a call |
|
748 * to CMdaAudioPlayerUtility::FixedSequenceCount() - 1. The |
|
749 * function raises a panic if sequence number is not within this |
|
750 * range. |
|
751 * @return const TDesC & A reference to a Descriptor containing the fixed |
|
752 * sequence name indexed by aSequenceNumber. |
|
753 */ |
|
754 IMPORT_C const TDesC& FixedSequenceName(TInt aSequenceNumber); |
|
755 |
715 |
756 /** |
716 /** |
757 * Returns a list of the supported input datatypes that can be sent to |
717 * Returns a list of the supported input datatypes that can be sent to |
758 * DevSound for playing audio. The datatypes returned are those that the |
718 * DevSound for playing audio. The datatypes returned are those that the |
759 * DevSound supports given the priority settings passed in |
719 * DevSound supports given the priority settings passed in |