alGetResource(3dm)					    alGetResource(3dm)

NAME    [Toc]    [Back]

     alGetResource - get the resource associated with an audio port

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/audio.h>

     int alGetResource(ALport port)

PARAMETER    [Toc]    [Back]

     port   expects the	port whose audio resource you desire.  This structure
	    is the returned value of an	alOpenPort(3dm)	call.

DESCRIPTION    [Toc]    [Back]

     An	audio resource (see alResources(3dm)) is a globally visible object
     upon which	certain	kinds of operations, such as getting and setting
     parameters, can be	performed. Audio devices are examples of resources.
     Ports, too, are resources,	and can	support	some of	the same operations as
     audio devices.

     alGetResource() returns a resource	associated with	the given port that
     you can then use, for example, as an argument to alGetParams(3dm) or
     alConnect(3dm).

DIAGNOSTICS    [Toc]    [Back]

     Upon successful completion, alGetResource returns nonzero resource.  In
     the event of an error, alGetResource returns 0 and	sets an	error code
     which can be retrieved with oserror(3C).

     alGetResource can fail for	the following reason:

     AL_BAD_PORT   port	is either invalid or null.

SEE ALSO    [Toc]    [Back]

     alOpenPort(3dm), alGetParams(3dm),	alConnect(3dm),	oserror(3C)


									PPPPaaaaggggeeee 1111