1AuCreateBucket(3)          Library Functions Manual          AuCreateBucket(3)
2
3
4

Name

6       AuCreateBucket - create a bucket
7

Synopsis

9       #include <audio/audiolib.h>
10
11       AuBucketID  AuCreateBucket(server, format, tracks, access, sample_rate,
12       nsamples, description, status)
13           AuServer *server;
14           AuUint32 format;
15           AuUint32 tracks;
16           AuUint32 access;
17           AuUint32 sample_rate;
18           AuUint32 num_samples;
19           AuString *description;
20           AuStatus *status; /* RETURN */
21

Arguments

23       server    Specifies the connection to the audio server.
24
25       format    Specifies the data format of the audio data.  Currently,  the
26                 following  formats  are  defined: AuFormatULAW8, AuFormatLin‐
27                 earUnsigned8,     AuFormatLinearSigned8,      AuFormatLinear‐
28                 Signed16MSB,  AuFormatLinearUnsigned16MSB, AuFormatSignedLin‐
29                 ear16LSB, and AuFormatLinearUnsigned16LSB.
30
31       tracks    Specifies the number of tracks of the audio data.
32
33       access    Specifies the types of operations permitted on  this  bucket.
34                 This  must be a bitwise inclusive OR of zero or more of these
35                 constants: AuAccessImportMask, AuAccessExportMask,  AuAccess‐
36                 DestroyMask, and AuAccessListMask.
37
38       sample_rate
39                 Specifies the sample rate of the audio data.
40
41       num_samples
42                 Specifies the number of samples the bucket will contain.
43
44       description
45                 Specifies  a  textual description of the bucket.  This may be
46                 NULL.
47
48       status    If non-NULL, flush the output buffer and  return  the  status
49                 from the server.
50

Description

52       AuCreateBucket  creates  a  bucket  with  the specified attributes, and
53       returns the bucket ID, or AuNone if there was an  error.   The  initial
54       contents of the bucket are undefined.
55

Errors

57       AuBadValue, AuBadLength, AuBadAlloc.
58

See Also

60       AuDestroyBucket,  AuSetBucketAttributes, AuListBuckets, AuFreeBucketAt‐
61       tributes.
62
63       audiolib - Network Audio System C Language Interface
64
65
66
67audiolib - bucket existence          1.9.1                   AuCreateBucket(3)
Impressum