/usr/src/packages/BUILD/alsa/alsa-lib-1.0.11rc2/include/seq.h

Go to the documentation of this file.
00001 
00009 /*
00010  * Application interface library for the ALSA driver
00011  *
00012  *
00013  *   This library is free software; you can redistribute it and/or modify
00014  *   it under the terms of the GNU Lesser General Public License as
00015  *   published by the Free Software Foundation; either version 2.1 of
00016  *   the License, or (at your option) any later version.
00017  *
00018  *   This program is distributed in the hope that it will be useful,
00019  *   but WITHOUT ANY WARRANTY; without even the implied warranty of
00020  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
00021  *   GNU Lesser General Public License for more details.
00022  *
00023  *   You should have received a copy of the GNU Lesser General Public
00024  *   License along with this library; if not, write to the Free Software
00025  *   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
00026  *
00027  */
00028 
00029 #ifndef __ALSA_SEQ_H
00030 #define __ALSA_SEQ_H
00031 
00032 #ifdef __cplusplus
00033 extern "C" {
00034 #endif
00035 
00044 #define SND_SEQ_DLSYM_VERSION           _dlsym_seq_001
00045 
00047 typedef struct _snd_seq snd_seq_t;
00048 
00049 #ifndef DOC_HIDDEN
00050 #define SND_ALLOCA(type,ptr) \
00051 do {\
00052         assert(ptr);\
00053         *ptr = (type##_t *)alloca(type##_sizeof());\
00054         memset(*ptr, 0, type##_sizeof());\
00055 } while (0)
00056 #endif
00057 
00061 #define SND_SEQ_OPEN_OUTPUT     1       
00062 #define SND_SEQ_OPEN_INPUT      2       
00063 #define SND_SEQ_OPEN_DUPLEX     (SND_SEQ_OPEN_OUTPUT|SND_SEQ_OPEN_INPUT)        
00068 #define SND_SEQ_NONBLOCK        0x0001  
00071 typedef enum _snd_seq_type {
00072         SND_SEQ_TYPE_HW,                
00073         SND_SEQ_TYPE_SHM,               
00074         SND_SEQ_TYPE_INET               
00075 } snd_seq_type_t;
00076 
00078 #define SND_SEQ_ADDRESS_UNKNOWN         253     
00079 #define SND_SEQ_ADDRESS_SUBSCRIBERS     254     
00080 #define SND_SEQ_ADDRESS_BROADCAST       255     
00083 #define SND_SEQ_CLIENT_SYSTEM           0       
00085 /*
00086  */
00087 int snd_seq_open(snd_seq_t **handle, const char *name, int streams, int mode);
00088 int snd_seq_open_lconf(snd_seq_t **handle, const char *name, int streams, int mode, snd_config_t *lconf);
00089 const char *snd_seq_name(snd_seq_t *seq);
00090 snd_seq_type_t snd_seq_type(snd_seq_t *seq);
00091 int snd_seq_close(snd_seq_t *handle);
00092 int snd_seq_poll_descriptors_count(snd_seq_t *handle, short events);
00093 int snd_seq_poll_descriptors(snd_seq_t *handle, struct pollfd *pfds, unsigned int space, short events);
00094 int snd_seq_poll_descriptors_revents(snd_seq_t *seq, struct pollfd *pfds, unsigned int nfds, unsigned short *revents);
00095 int snd_seq_nonblock(snd_seq_t *handle, int nonblock);
00096 int snd_seq_client_id(snd_seq_t *handle);
00097 
00098 size_t snd_seq_get_output_buffer_size(snd_seq_t *handle);
00099 size_t snd_seq_get_input_buffer_size(snd_seq_t *handle);
00100 int snd_seq_set_output_buffer_size(snd_seq_t *handle, size_t size);
00101 int snd_seq_set_input_buffer_size(snd_seq_t *handle, size_t size);
00102 
00104 typedef struct _snd_seq_system_info snd_seq_system_info_t;
00105 
00106 size_t snd_seq_system_info_sizeof(void);
00108 #define snd_seq_system_info_alloca(ptr) \
00109         SND_ALLOCA(snd_seq_system_info, ptr)
00110 int snd_seq_system_info_malloc(snd_seq_system_info_t **ptr);
00111 void snd_seq_system_info_free(snd_seq_system_info_t *ptr);
00112 void snd_seq_system_info_copy(snd_seq_system_info_t *dst, const snd_seq_system_info_t *src);
00113 
00114 int snd_seq_system_info_get_queues(const snd_seq_system_info_t *info);
00115 int snd_seq_system_info_get_clients(const snd_seq_system_info_t *info);
00116 int snd_seq_system_info_get_ports(const snd_seq_system_info_t *info);
00117 int snd_seq_system_info_get_channels(const snd_seq_system_info_t *info);
00118 int snd_seq_system_info_get_cur_clients(const snd_seq_system_info_t *info);
00119 int snd_seq_system_info_get_cur_queues(const snd_seq_system_info_t *info);
00120 
00121 int snd_seq_system_info(snd_seq_t *handle, snd_seq_system_info_t *info);
00122 
00134 typedef struct _snd_seq_client_info snd_seq_client_info_t;
00135 
00137 typedef enum snd_seq_client_type {
00138         SND_SEQ_USER_CLIENT     = 1,    
00139         SND_SEQ_KERNEL_CLIENT   = 2     
00140 } snd_seq_client_type_t;
00141                         
00142 size_t snd_seq_client_info_sizeof(void);
00144 #define snd_seq_client_info_alloca(ptr) \
00145         SND_ALLOCA(snd_seq_client_info, ptr)
00146 int snd_seq_client_info_malloc(snd_seq_client_info_t **ptr);
00147 void snd_seq_client_info_free(snd_seq_client_info_t *ptr);
00148 void snd_seq_client_info_copy(snd_seq_client_info_t *dst, const snd_seq_client_info_t *src);
00149 
00150 int snd_seq_client_info_get_client(const snd_seq_client_info_t *info);
00151 snd_seq_client_type_t snd_seq_client_info_get_type(const snd_seq_client_info_t *info);
00152 const char *snd_seq_client_info_get_name(snd_seq_client_info_t *info);
00153 int snd_seq_client_info_get_broadcast_filter(const snd_seq_client_info_t *info);
00154 int snd_seq_client_info_get_error_bounce(const snd_seq_client_info_t *info);
00155 const unsigned char *snd_seq_client_info_get_event_filter(const snd_seq_client_info_t *info);
00156 int snd_seq_client_info_get_num_ports(const snd_seq_client_info_t *info);
00157 int snd_seq_client_info_get_event_lost(const snd_seq_client_info_t *info);
00158 
00159 void snd_seq_client_info_set_client(snd_seq_client_info_t *info, int client);
00160 void snd_seq_client_info_set_name(snd_seq_client_info_t *info, const char *name);
00161 void snd_seq_client_info_set_broadcast_filter(snd_seq_client_info_t *info, int val);
00162 void snd_seq_client_info_set_error_bounce(snd_seq_client_info_t *info, int val);
00163 void snd_seq_client_info_set_event_filter(snd_seq_client_info_t *info, unsigned char *filter);
00164 
00165 int snd_seq_get_client_info(snd_seq_t *handle, snd_seq_client_info_t *info);
00166 int snd_seq_get_any_client_info(snd_seq_t *handle, int client, snd_seq_client_info_t *info);
00167 int snd_seq_set_client_info(snd_seq_t *handle, snd_seq_client_info_t *info);
00168 int snd_seq_query_next_client(snd_seq_t *handle, snd_seq_client_info_t *info);
00169 
00170 /*
00171  */
00172 
00174 typedef struct _snd_seq_client_pool snd_seq_client_pool_t;
00175 
00176 size_t snd_seq_client_pool_sizeof(void);
00178 #define snd_seq_client_pool_alloca(ptr) \
00179         SND_ALLOCA(snd_seq_client_pool, ptr)
00180 int snd_seq_client_pool_malloc(snd_seq_client_pool_t **ptr);
00181 void snd_seq_client_pool_free(snd_seq_client_pool_t *ptr);
00182 void snd_seq_client_pool_copy(snd_seq_client_pool_t *dst, const snd_seq_client_pool_t *src);
00183 
00184 int snd_seq_client_pool_get_client(const snd_seq_client_pool_t *info);
00185 size_t snd_seq_client_pool_get_output_pool(const snd_seq_client_pool_t *info);
00186 size_t snd_seq_client_pool_get_input_pool(const snd_seq_client_pool_t *info);
00187 size_t snd_seq_client_pool_get_output_room(const snd_seq_client_pool_t *info);
00188 size_t snd_seq_client_pool_get_output_free(const snd_seq_client_pool_t *info);
00189 size_t snd_seq_client_pool_get_input_free(const snd_seq_client_pool_t *info);
00190 void snd_seq_client_pool_set_output_pool(snd_seq_client_pool_t *info, size_t size);
00191 void snd_seq_client_pool_set_input_pool(snd_seq_client_pool_t *info, size_t size);
00192 void snd_seq_client_pool_set_output_room(snd_seq_client_pool_t *info, size_t size);
00193 
00194 int snd_seq_get_client_pool(snd_seq_t *handle, snd_seq_client_pool_t *info);
00195 int snd_seq_set_client_pool(snd_seq_t *handle, snd_seq_client_pool_t *info);
00196 
00197 
00209 typedef struct _snd_seq_port_info snd_seq_port_info_t;
00210 
00212 #define SND_SEQ_PORT_SYSTEM_TIMER       0       
00213 #define SND_SEQ_PORT_SYSTEM_ANNOUNCE    1       
00216 #define SND_SEQ_PORT_CAP_READ           (1<<0)  
00217 #define SND_SEQ_PORT_CAP_WRITE          (1<<1)  
00219 #define SND_SEQ_PORT_CAP_SYNC_READ      (1<<2)  
00220 #define SND_SEQ_PORT_CAP_SYNC_WRITE     (1<<3)  
00222 #define SND_SEQ_PORT_CAP_DUPLEX         (1<<4)  
00224 #define SND_SEQ_PORT_CAP_SUBS_READ      (1<<5)  
00225 #define SND_SEQ_PORT_CAP_SUBS_WRITE     (1<<6)  
00226 #define SND_SEQ_PORT_CAP_NO_EXPORT      (1<<7)  
00229 #define SND_SEQ_PORT_TYPE_SPECIFIC      (1<<0)  
00230 #define SND_SEQ_PORT_TYPE_MIDI_GENERIC  (1<<1)  
00231 #define SND_SEQ_PORT_TYPE_MIDI_GM       (1<<2)  
00232 #define SND_SEQ_PORT_TYPE_MIDI_GS       (1<<3)  
00233 #define SND_SEQ_PORT_TYPE_MIDI_XG       (1<<4)  
00234 #define SND_SEQ_PORT_TYPE_MIDI_MT32     (1<<5)  
00235 #define SND_SEQ_PORT_TYPE_SYNTH         (1<<10) 
00236 #define SND_SEQ_PORT_TYPE_DIRECT_SAMPLE (1<<11) 
00237 #define SND_SEQ_PORT_TYPE_SAMPLE        (1<<12) 
00238 #define SND_SEQ_PORT_TYPE_APPLICATION   (1<<20) 
00241 size_t snd_seq_port_info_sizeof(void);
00242 
00243 #define snd_seq_port_info_alloca(ptr) \
00244         SND_ALLOCA(snd_seq_port_info, ptr)
00245 int snd_seq_port_info_malloc(snd_seq_port_info_t **ptr);
00246 void snd_seq_port_info_free(snd_seq_port_info_t *ptr);
00247 void snd_seq_port_info_copy(snd_seq_port_info_t *dst, const snd_seq_port_info_t *src);
00248 
00249 int snd_seq_port_info_get_client(const snd_seq_port_info_t *info);
00250 int snd_seq_port_info_get_port(const snd_seq_port_info_t *info);
00251 const snd_seq_addr_t *snd_seq_port_info_get_addr(const snd_seq_port_info_t *info);
00252 const char *snd_seq_port_info_get_name(const snd_seq_port_info_t *info);
00253 unsigned int snd_seq_port_info_get_capability(const snd_seq_port_info_t *info);
00254 unsigned int snd_seq_port_info_get_type(const snd_seq_port_info_t *info);
00255 int snd_seq_port_info_get_midi_channels(const snd_seq_port_info_t *info);
00256 int snd_seq_port_info_get_midi_voices(const snd_seq_port_info_t *info);
00257 int snd_seq_port_info_get_synth_voices(const snd_seq_port_info_t *info);
00258 int snd_seq_port_info_get_read_use(const snd_seq_port_info_t *info);
00259 int snd_seq_port_info_get_write_use(const snd_seq_port_info_t *info);
00260 int snd_seq_port_info_get_port_specified(const snd_seq_port_info_t *info);
00261 int snd_seq_port_info_get_timestamping(const snd_seq_port_info_t *info);
00262 int snd_seq_port_info_get_timestamp_real(const snd_seq_port_info_t *info);
00263 int snd_seq_port_info_get_timestamp_queue(const snd_seq_port_info_t *info);
00264 
00265 void snd_seq_port_info_set_client(snd_seq_port_info_t *info, int client);
00266 void snd_seq_port_info_set_port(snd_seq_port_info_t *info, int port);
00267 void snd_seq_port_info_set_addr(snd_seq_port_info_t *info, const snd_seq_addr_t *addr);
00268 void snd_seq_port_info_set_name(snd_seq_port_info_t *info, const char *name);
00269 void snd_seq_port_info_set_capability(snd_seq_port_info_t *info, unsigned int capability);
00270 void snd_seq_port_info_set_type(snd_seq_port_info_t *info, unsigned int type);
00271 void snd_seq_port_info_set_midi_channels(snd_seq_port_info_t *info, int channels);
00272 void snd_seq_port_info_set_midi_voices(snd_seq_port_info_t *info, int voices);
00273 void snd_seq_port_info_set_synth_voices(snd_seq_port_info_t *info, int voices);
00274 void snd_seq_port_info_set_port_specified(snd_seq_port_info_t *info, int val);
00275 void snd_seq_port_info_set_timestamping(snd_seq_port_info_t *info, int enable);
00276 void snd_seq_port_info_set_timestamp_real(snd_seq_port_info_t *info, int realtime);
00277 void snd_seq_port_info_set_timestamp_queue(snd_seq_port_info_t *info, int queue);
00278 
00279 int snd_seq_create_port(snd_seq_t *handle, snd_seq_port_info_t *info);
00280 int snd_seq_delete_port(snd_seq_t *handle, int port);
00281 int snd_seq_get_port_info(snd_seq_t *handle, int port, snd_seq_port_info_t *info);
00282 int snd_seq_get_any_port_info(snd_seq_t *handle, int client, int port, snd_seq_port_info_t *info);
00283 int snd_seq_set_port_info(snd_seq_t *handle, int port, snd_seq_port_info_t *info);
00284 int snd_seq_query_next_port(snd_seq_t *handle, snd_seq_port_info_t *info);
00285 
00297 typedef struct _snd_seq_port_subscribe snd_seq_port_subscribe_t;
00298 
00299 size_t snd_seq_port_subscribe_sizeof(void);
00301 #define snd_seq_port_subscribe_alloca(ptr) \
00302         SND_ALLOCA(snd_seq_port_subscribe, ptr)
00303 int snd_seq_port_subscribe_malloc(snd_seq_port_subscribe_t **ptr);
00304 void snd_seq_port_subscribe_free(snd_seq_port_subscribe_t *ptr);
00305 void snd_seq_port_subscribe_copy(snd_seq_port_subscribe_t *dst, const snd_seq_port_subscribe_t *src);
00306 
00307 const snd_seq_addr_t *snd_seq_port_subscribe_get_sender(const snd_seq_port_subscribe_t *info);
00308 const snd_seq_addr_t *snd_seq_port_subscribe_get_dest(const snd_seq_port_subscribe_t *info);
00309 int snd_seq_port_subscribe_get_queue(const snd_seq_port_subscribe_t *info);
00310 int snd_seq_port_subscribe_get_exclusive(const snd_seq_port_subscribe_t *info);
00311 int snd_seq_port_subscribe_get_time_update(const snd_seq_port_subscribe_t *info);
00312 int snd_seq_port_subscribe_get_time_real(const snd_seq_port_subscribe_t *info);
00313 
00314 void snd_seq_port_subscribe_set_sender(snd_seq_port_subscribe_t *info, const snd_seq_addr_t *addr);
00315 void snd_seq_port_subscribe_set_dest(snd_seq_port_subscribe_t *info, const snd_seq_addr_t *addr);
00316 void snd_seq_port_subscribe_set_queue(snd_seq_port_subscribe_t *info, int q);
00317 void snd_seq_port_subscribe_set_exclusive(snd_seq_port_subscribe_t *info, int val);
00318 void snd_seq_port_subscribe_set_time_update(snd_seq_port_subscribe_t *info, int val);
00319 void snd_seq_port_subscribe_set_time_real(snd_seq_port_subscribe_t *info, int val);
00320 
00321 int snd_seq_get_port_subscription(snd_seq_t *handle, snd_seq_port_subscribe_t *sub);
00322 int snd_seq_subscribe_port(snd_seq_t *handle, snd_seq_port_subscribe_t *sub);
00323 int snd_seq_unsubscribe_port(snd_seq_t *handle, snd_seq_port_subscribe_t *sub);
00324 
00325 /*
00326  */
00327 
00329 typedef struct _snd_seq_query_subscribe snd_seq_query_subscribe_t;
00330 
00332 typedef enum {
00333         SND_SEQ_QUERY_SUBS_READ,        
00334         SND_SEQ_QUERY_SUBS_WRITE        
00335 } snd_seq_query_subs_type_t;
00336 
00337 size_t snd_seq_query_subscribe_sizeof(void);
00339 #define snd_seq_query_subscribe_alloca(ptr) \
00340         SND_ALLOCA(snd_seq_query_subscribe, ptr)
00341 int snd_seq_query_subscribe_malloc(snd_seq_query_subscribe_t **ptr);
00342 void snd_seq_query_subscribe_free(snd_seq_query_subscribe_t *ptr);
00343 void snd_seq_query_subscribe_copy(snd_seq_query_subscribe_t *dst, const snd_seq_query_subscribe_t *src);
00344 
00345 int snd_seq_query_subscribe_get_client(const snd_seq_query_subscribe_t *info);
00346 int snd_seq_query_subscribe_get_port(const snd_seq_query_subscribe_t *info);
00347 const snd_seq_addr_t *snd_seq_query_subscribe_get_root(const snd_seq_query_subscribe_t *info);
00348 snd_seq_query_subs_type_t snd_seq_query_subscribe_get_type(const snd_seq_query_subscribe_t *info);
00349 int snd_seq_query_subscribe_get_index(const snd_seq_query_subscribe_t *info);
00350 int snd_seq_query_subscribe_get_num_subs(const snd_seq_query_subscribe_t *info);
00351 const snd_seq_addr_t *snd_seq_query_subscribe_get_addr(const snd_seq_query_subscribe_t *info);
00352 int snd_seq_query_subscribe_get_queue(const snd_seq_query_subscribe_t *info);
00353 int snd_seq_query_subscribe_get_exclusive(const snd_seq_query_subscribe_t *info);
00354 int snd_seq_query_subscribe_get_time_update(const snd_seq_query_subscribe_t *info);
00355 int snd_seq_query_subscribe_get_time_real(const snd_seq_query_subscribe_t *info);
00356 
00357 void snd_seq_query_subscribe_set_client(snd_seq_query_subscribe_t *info, int client);
00358 void snd_seq_query_subscribe_set_port(snd_seq_query_subscribe_t *info, int port);
00359 void snd_seq_query_subscribe_set_root(snd_seq_query_subscribe_t *info, const snd_seq_addr_t *addr);
00360 void snd_seq_query_subscribe_set_type(snd_seq_query_subscribe_t *info, snd_seq_query_subs_type_t type);
00361 void snd_seq_query_subscribe_set_index(snd_seq_query_subscribe_t *info, int _index);
00362 
00363 int snd_seq_query_port_subscribers(snd_seq_t *seq, snd_seq_query_subscribe_t * subs);
00364 
00376 typedef struct _snd_seq_queue_info snd_seq_queue_info_t;
00378 typedef struct _snd_seq_queue_status snd_seq_queue_status_t;
00380 typedef struct _snd_seq_queue_tempo snd_seq_queue_tempo_t;
00382 typedef struct _snd_seq_queue_timer snd_seq_queue_timer_t;
00383 
00385 #define SND_SEQ_QUEUE_DIRECT            253     
00387 size_t snd_seq_queue_info_sizeof(void);
00388 
00389 #define snd_seq_queue_info_alloca(ptr) \
00390         SND_ALLOCA(snd_seq_queue_info, ptr)
00391 int snd_seq_queue_info_malloc(snd_seq_queue_info_t **ptr);
00392 void snd_seq_queue_info_free(snd_seq_queue_info_t *ptr);
00393 void snd_seq_queue_info_copy(snd_seq_queue_info_t *dst, const snd_seq_queue_info_t *src);
00394 
00395 int snd_seq_queue_info_get_queue(const snd_seq_queue_info_t *info);
00396 const char *snd_seq_queue_info_get_name(const snd_seq_queue_info_t *info);
00397 int snd_seq_queue_info_get_owner(const snd_seq_queue_info_t *info);
00398 int snd_seq_queue_info_get_locked(const snd_seq_queue_info_t *info);
00399 unsigned int snd_seq_queue_info_get_flags(const snd_seq_queue_info_t *info);
00400 
00401 void snd_seq_queue_info_set_name(snd_seq_queue_info_t *info, const char *name);
00402 void snd_seq_queue_info_set_owner(snd_seq_queue_info_t *info, int owner);
00403 void snd_seq_queue_info_set_locked(snd_seq_queue_info_t *info, int locked);
00404 void snd_seq_queue_info_set_flags(snd_seq_queue_info_t *info, unsigned int flags);
00405 
00406 int snd_seq_create_queue(snd_seq_t *seq, snd_seq_queue_info_t *info);
00407 int snd_seq_alloc_named_queue(snd_seq_t *seq, const char *name);
00408 int snd_seq_alloc_queue(snd_seq_t *handle);
00409 int snd_seq_free_queue(snd_seq_t *handle, int q);
00410 int snd_seq_get_queue_info(snd_seq_t *seq, int q, snd_seq_queue_info_t *info);
00411 int snd_seq_set_queue_info(snd_seq_t *seq, int q, snd_seq_queue_info_t *info);
00412 int snd_seq_query_named_queue(snd_seq_t *seq, const char *name);
00413 
00414 int snd_seq_get_queue_usage(snd_seq_t *handle, int q);
00415 int snd_seq_set_queue_usage(snd_seq_t *handle, int q, int used);
00416 
00417 /*
00418  */
00419 size_t snd_seq_queue_status_sizeof(void);
00421 #define snd_seq_queue_status_alloca(ptr) \
00422         SND_ALLOCA(snd_seq_queue_status, ptr)
00423 int snd_seq_queue_status_malloc(snd_seq_queue_status_t **ptr);
00424 void snd_seq_queue_status_free(snd_seq_queue_status_t *ptr);
00425 void snd_seq_queue_status_copy(snd_seq_queue_status_t *dst, const snd_seq_queue_status_t *src);
00426 
00427 int snd_seq_queue_status_get_queue(const snd_seq_queue_status_t *info);
00428 int snd_seq_queue_status_get_events(const snd_seq_queue_status_t *info);
00429 snd_seq_tick_time_t snd_seq_queue_status_get_tick_time(const snd_seq_queue_status_t *info);
00430 const snd_seq_real_time_t *snd_seq_queue_status_get_real_time(const snd_seq_queue_status_t *info);
00431 unsigned int snd_seq_queue_status_get_status(const snd_seq_queue_status_t *info);
00432 
00433 int snd_seq_get_queue_status(snd_seq_t *handle, int q, snd_seq_queue_status_t *status);
00434 
00435 /*
00436  */
00437 size_t snd_seq_queue_tempo_sizeof(void);
00439 #define snd_seq_queue_tempo_alloca(ptr) \
00440         SND_ALLOCA(snd_seq_queue_tempo, ptr)
00441 int snd_seq_queue_tempo_malloc(snd_seq_queue_tempo_t **ptr);
00442 void snd_seq_queue_tempo_free(snd_seq_queue_tempo_t *ptr);
00443 void snd_seq_queue_tempo_copy(snd_seq_queue_tempo_t *dst, const snd_seq_queue_tempo_t *src);
00444 
00445 int snd_seq_queue_tempo_get_queue(const snd_seq_queue_tempo_t *info);
00446 unsigned int snd_seq_queue_tempo_get_tempo(const snd_seq_queue_tempo_t *info);
00447 int snd_seq_queue_tempo_get_ppq(const snd_seq_queue_tempo_t *info);
00448 unsigned int snd_seq_queue_tempo_get_skew(const snd_seq_queue_tempo_t *info);
00449 unsigned int snd_seq_queue_tempo_get_skew_base(const snd_seq_queue_tempo_t *info);
00450 void snd_seq_queue_tempo_set_tempo(snd_seq_queue_tempo_t *info, unsigned int tempo);
00451 void snd_seq_queue_tempo_set_ppq(snd_seq_queue_tempo_t *info, int ppq);
00452 void snd_seq_queue_tempo_set_skew(snd_seq_queue_tempo_t *info, unsigned int skew);
00453 void snd_seq_queue_tempo_set_skew_base(snd_seq_queue_tempo_t *info, unsigned int base);
00454 
00455 int snd_seq_get_queue_tempo(snd_seq_t *handle, int q, snd_seq_queue_tempo_t *tempo);
00456 int snd_seq_set_queue_tempo(snd_seq_t *handle, int q, snd_seq_queue_tempo_t *tempo);
00457 
00458 /*
00459  */
00460 
00462 typedef enum {
00463         SND_SEQ_TIMER_ALSA = 0,         /* ALSA timer */
00464         SND_SEQ_TIMER_MIDI_CLOCK = 1,   /* Midi Clock (CLOCK event) */
00465         SND_SEQ_TIMER_MIDI_TICK = 2     /* Midi Timer Tick (TICK event */
00466 } snd_seq_queue_timer_type_t;
00467 
00468 size_t snd_seq_queue_timer_sizeof(void);
00470 #define snd_seq_queue_timer_alloca(ptr) \
00471         SND_ALLOCA(snd_seq_queue_timer, ptr)
00472 int snd_seq_queue_timer_malloc(snd_seq_queue_timer_t **ptr);
00473 void snd_seq_queue_timer_free(snd_seq_queue_timer_t *ptr);
00474 void snd_seq_queue_timer_copy(snd_seq_queue_timer_t *dst, const snd_seq_queue_timer_t *src);
00475 
00476 int snd_seq_queue_timer_get_queue(const snd_seq_queue_timer_t *info);
00477 snd_seq_queue_timer_type_t snd_seq_queue_timer_get_type(const snd_seq_queue_timer_t *info);
00478 const snd_timer_id_t *snd_seq_queue_timer_get_id(const snd_seq_queue_timer_t *info);
00479 unsigned int snd_seq_queue_timer_get_resolution(const snd_seq_queue_timer_t *info);
00480 
00481 void snd_seq_queue_timer_set_type(snd_seq_queue_timer_t *info, snd_seq_queue_timer_type_t type);
00482 void snd_seq_queue_timer_set_id(snd_seq_queue_timer_t *info, const snd_timer_id_t *id);
00483 void snd_seq_queue_timer_set_resolution(snd_seq_queue_timer_t *info, unsigned int resolution);
00484 
00485 int snd_seq_get_queue_timer(snd_seq_t *handle, int q, snd_seq_queue_timer_t *timer);
00486 int snd_seq_set_queue_timer(snd_seq_t *handle, int q, snd_seq_queue_timer_t *timer);
00487 
00497 int snd_seq_free_event(snd_seq_event_t *ev);
00498 ssize_t snd_seq_event_length(snd_seq_event_t *ev);
00499 int snd_seq_event_output(snd_seq_t *handle, snd_seq_event_t *ev);
00500 int snd_seq_event_output_buffer(snd_seq_t *handle, snd_seq_event_t *ev);
00501 int snd_seq_event_output_direct(snd_seq_t *handle, snd_seq_event_t *ev);
00502 int snd_seq_event_input(snd_seq_t *handle, snd_seq_event_t **ev);
00503 int snd_seq_event_input_pending(snd_seq_t *seq, int fetch_sequencer);
00504 int snd_seq_drain_output(snd_seq_t *handle);
00505 int snd_seq_event_output_pending(snd_seq_t *seq);
00506 int snd_seq_extract_output(snd_seq_t *handle, snd_seq_event_t **ev);
00507 int snd_seq_drop_output(snd_seq_t *handle);
00508 int snd_seq_drop_output_buffer(snd_seq_t *handle);
00509 int snd_seq_drop_input(snd_seq_t *handle);
00510 int snd_seq_drop_input_buffer(snd_seq_t *handle);
00511 
00513 typedef struct _snd_seq_remove_events snd_seq_remove_events_t;
00514 
00516 #define SND_SEQ_REMOVE_INPUT            (1<<0)  
00517 #define SND_SEQ_REMOVE_OUTPUT           (1<<1)  
00518 #define SND_SEQ_REMOVE_DEST             (1<<2)  
00519 #define SND_SEQ_REMOVE_DEST_CHANNEL     (1<<3)  
00520 #define SND_SEQ_REMOVE_TIME_BEFORE      (1<<4)  
00521 #define SND_SEQ_REMOVE_TIME_AFTER       (1<<5)  
00522 #define SND_SEQ_REMOVE_TIME_TICK        (1<<6)  
00523 #define SND_SEQ_REMOVE_EVENT_TYPE       (1<<7)  
00524 #define SND_SEQ_REMOVE_IGNORE_OFF       (1<<8)  
00525 #define SND_SEQ_REMOVE_TAG_MATCH        (1<<9)  
00527 size_t snd_seq_remove_events_sizeof(void);
00528 
00529 #define snd_seq_remove_events_alloca(ptr) \
00530         SND_ALLOCA(snd_seq_remove_events, ptr)
00531 int snd_seq_remove_events_malloc(snd_seq_remove_events_t **ptr);
00532 void snd_seq_remove_events_free(snd_seq_remove_events_t *ptr);
00533 void snd_seq_remove_events_copy(snd_seq_remove_events_t *dst, const snd_seq_remove_events_t *src);
00534 
00535 unsigned int snd_seq_remove_events_get_condition(const snd_seq_remove_events_t *info);
00536 int snd_seq_remove_events_get_queue(const snd_seq_remove_events_t *info);
00537 const snd_seq_timestamp_t *snd_seq_remove_events_get_time(const snd_seq_remove_events_t *info);
00538 const snd_seq_addr_t *snd_seq_remove_events_get_dest(const snd_seq_remove_events_t *info);
00539 int snd_seq_remove_events_get_channel(const snd_seq_remove_events_t *info);
00540 int snd_seq_remove_events_get_event_type(const snd_seq_remove_events_t *info);
00541 int snd_seq_remove_events_get_tag(const snd_seq_remove_events_t *info);
00542 
00543 void snd_seq_remove_events_set_condition(snd_seq_remove_events_t *info, unsigned int flags);
00544 void snd_seq_remove_events_set_queue(snd_seq_remove_events_t *info, int queue);
00545 void snd_seq_remove_events_set_time(snd_seq_remove_events_t *info, const snd_seq_timestamp_t *time);
00546 void snd_seq_remove_events_set_dest(snd_seq_remove_events_t *info, const snd_seq_addr_t *addr);
00547 void snd_seq_remove_events_set_channel(snd_seq_remove_events_t *info, int channel);
00548 void snd_seq_remove_events_set_event_type(snd_seq_remove_events_t *info, int type);
00549 void snd_seq_remove_events_set_tag(snd_seq_remove_events_t *info, int tag);
00550 
00551 int snd_seq_remove_events(snd_seq_t *handle, snd_seq_remove_events_t *info);
00552 
00562 void snd_seq_set_bit(int nr, void *array);
00563 int snd_seq_change_bit(int nr, void *array);
00564 int snd_seq_get_bit(int nr, void *array);
00565 
00576 /* event type macros */
00577 enum {
00578         SND_SEQ_EVFLG_RESULT,
00579         SND_SEQ_EVFLG_NOTE,
00580         SND_SEQ_EVFLG_CONTROL,
00581         SND_SEQ_EVFLG_QUEUE,
00582         SND_SEQ_EVFLG_SYSTEM,
00583         SND_SEQ_EVFLG_MESSAGE,
00584         SND_SEQ_EVFLG_CONNECTION,
00585         SND_SEQ_EVFLG_SAMPLE,
00586         SND_SEQ_EVFLG_USERS,
00587         SND_SEQ_EVFLG_INSTR,
00588         SND_SEQ_EVFLG_QUOTE,
00589         SND_SEQ_EVFLG_NONE,
00590         SND_SEQ_EVFLG_RAW,
00591         SND_SEQ_EVFLG_FIXED,
00592         SND_SEQ_EVFLG_VARIABLE,
00593         SND_SEQ_EVFLG_VARUSR
00594 };
00595 
00596 enum {
00597         SND_SEQ_EVFLG_NOTE_ONEARG,
00598         SND_SEQ_EVFLG_NOTE_TWOARG
00599 };
00600 
00601 enum {
00602         SND_SEQ_EVFLG_QUEUE_NOARG,
00603         SND_SEQ_EVFLG_QUEUE_TICK,
00604         SND_SEQ_EVFLG_QUEUE_TIME,
00605         SND_SEQ_EVFLG_QUEUE_VALUE
00606 };
00607 
00613 extern const unsigned int snd_seq_event_types[];
00614 
00615 #define _SND_SEQ_TYPE(x)        (1<<(x))        
00616 #define _SND_SEQ_TYPE_OPT(x)    ((x)<<24)       
00619 #define snd_seq_type_check(ev,x) (snd_seq_event_types[(ev)->type] & _SND_SEQ_TYPE(x))
00620 
00622 #define snd_seq_ev_is_result_type(ev) \
00623         snd_seq_type_check(ev, SND_SEQ_EVFLG_RESULT)
00624 
00625 #define snd_seq_ev_is_note_type(ev) \
00626         snd_seq_type_check(ev, SND_SEQ_EVFLG_NOTE)
00627 
00628 #define snd_seq_ev_is_control_type(ev) \
00629         snd_seq_type_check(ev, SND_SEQ_EVFLG_CONTROL)
00630 
00631 #define snd_seq_ev_is_channel_type(ev) \
00632         (snd_seq_event_types[(ev)->type] & (_SND_SEQ_TYPE(SND_SEQ_EVFLG_NOTE) | _SND_SEQ_TYPE(SND_SEQ_EVFLG_CONTROL)))
00633 
00635 #define snd_seq_ev_is_queue_type(ev) \
00636         snd_seq_type_check(ev, SND_SEQ_EVFLG_QUEUE)
00637 
00638 #define snd_seq_ev_is_message_type(ev) \
00639         snd_seq_type_check(ev, SND_SEQ_EVFLG_MESSAGE)
00640 
00641 #define snd_seq_ev_is_subscribe_type(ev) \
00642         snd_seq_type_check(ev, SND_SEQ_EVFLG_CONNECTION)
00643 
00644 #define snd_seq_ev_is_sample_type(ev) \
00645         snd_seq_type_check(ev, SND_SEQ_EVFLG_SAMPLE)
00646 
00647 #define snd_seq_ev_is_user_type(ev) \
00648         snd_seq_type_check(ev, SND_SEQ_EVFLG_USERS)
00649 
00650 #define snd_seq_ev_is_instr_type(ev) \
00651         snd_seq_type_check(ev, SND_SEQ_EVFLG_INSTR)
00652 
00653 #define snd_seq_ev_is_fixed_type(ev) \
00654         snd_seq_type_check(ev, SND_SEQ_EVFLG_FIXED)
00655 
00656 #define snd_seq_ev_is_variable_type(ev) \
00657         snd_seq_type_check(ev, SND_SEQ_EVFLG_VARIABLE)
00658 
00659 #define snd_seq_ev_is_varusr_type(ev) \
00660         snd_seq_type_check(ev, SND_SEQ_EVFLG_VARUSR)
00661 
00662 #define snd_seq_ev_is_reserved(ev) \
00663         (! snd_seq_event_types[(ev)->type])
00664 
00669 #define snd_seq_ev_is_prior(ev) \
00670         (((ev)->flags & SND_SEQ_PRIORITY_MASK) == SND_SEQ_PRIORITY_HIGH)
00671 
00673 #define snd_seq_ev_length_type(ev) \
00674         ((ev)->flags & SND_SEQ_EVENT_LENGTH_MASK)
00675 
00676 #define snd_seq_ev_is_fixed(ev) \
00677         (snd_seq_ev_length_type(ev) == SND_SEQ_EVENT_LENGTH_FIXED)
00678 
00679 #define snd_seq_ev_is_variable(ev) \
00680         (snd_seq_ev_length_type(ev) == SND_SEQ_EVENT_LENGTH_VARIABLE)
00681 
00682 #define snd_seq_ev_is_varusr(ev) \
00683         (snd_seq_ev_length_type(ev) == SND_SEQ_EVENT_LENGTH_VARUSR)
00684 
00686 #define snd_seq_ev_timestamp_type(ev) \
00687         ((ev)->flags & SND_SEQ_TIME_STAMP_MASK)
00688 
00689 #define snd_seq_ev_is_tick(ev) \
00690         (snd_seq_ev_timestamp_type(ev) == SND_SEQ_TIME_STAMP_TICK)
00691 
00692 #define snd_seq_ev_is_real(ev) \
00693         (snd_seq_ev_timestamp_type(ev) == SND_SEQ_TIME_STAMP_REAL)
00694 
00696 #define snd_seq_ev_timemode_type(ev) \
00697         ((ev)->flags & SND_SEQ_TIME_MODE_MASK)
00698 
00699 #define snd_seq_ev_is_abstime(ev) \
00700         (snd_seq_ev_timemode_type(ev) == SND_SEQ_TIME_MODE_ABS)
00701 
00702 #define snd_seq_ev_is_reltime(ev) \
00703         (snd_seq_ev_timemode_type(ev) == SND_SEQ_TIME_MODE_REL)
00704 
00706 #define snd_seq_ev_is_direct(ev) \
00707         ((ev)->queue == SND_SEQ_QUEUE_DIRECT)
00708 
00711 #ifdef __cplusplus
00712 }
00713 #endif
00714 
00715 #endif /* __ALSA_SEQ_H */
00716 

Generated on Fri Jun 16 14:42:46 2006 for ALSA project - the C library reference by  doxygen 1.4.6