alGetResource(3dm)

NAME
     alGetResource - get the resource associated with an audio port

SYNOPSIS
     #include <dmedia/audio.h>

     int alGetResource(ALport port)

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

DESCRIPTION
     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
     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
     alOpenPort(3dm), alGetParams(3dm), alConnect(3dm), oserror(3C)