pa_linux_pulseaudio_internal.h File Reference

#include "pa_util.h"
#include "pa_allocation.h"
#include "pa_hostapi.h"
#include "pa_stream.h"
#include "pa_cpuload.h"
#include "pa_process.h"
#include "pa_unix_util.h"
#include "pa_ringbuffer.h"
#include "pa_debugprint.h"
#include <stdio.h>
#include <string.h>
#include <pulse/pulseaudio.h>

Go to the source code of this file.

Data Structures
struct	PaPulseAudio_HostApiRepresentation
struct	PaPulseAudio_Stream

Macros
#define	PA_PULSEAUDIO_SET_LAST_HOST_ERROR(errorCode, errorText)
#define	PAPULSEAUDIO_MAX_DEVICECOUNT   1024
#define	PAPULSEAUDIO_MAX_DEVICENAME   1024
#define	PA_PULSEAUDIO_DEFAULT_MIN_LATENCY   0.010
#define	PA_PULSEAUDIO_DEFAULT_MAX_LATENCY   0.080
#define	PAPULSEAUDIO_FRAMESPERBUFFERUNSPEC   32
#define	PULSEAUDIO_BUFFER_SIZE   (96100 * 4 * 2)
#define	PA_PULSEAUDIO_IS_ERROR(pastream, errorCode)

Typedefs
typedef struct PaPulseAudio_Stream	PaPulseAudio_Stream

Functions
void	PaPulseAudio_ReleaseOperation (PaPulseAudio_HostApiRepresentation *hostapi, pa_operation **pulseaudioOperation)
void	PaPulseAudio_Lock (pa_threaded_mainloop *mainloop)
void	PaPulseAudio_UnLock (pa_threaded_mainloop *mainloop)
PaError	PaPulseAudio_Initialize (PaUtilHostApiRepresentation **hostApi, PaHostApiIndex index)
void	Terminate (struct PaUtilHostApiRepresentation *hostApi)
PaError	IsFormatSupported (struct PaUtilHostApiRepresentation *hostApi, const PaStreamParameters *inputParameters, const PaStreamParameters *outputParameters, double sampleRate)
PaError	OpenStream (struct PaUtilHostApiRepresentation *hostApi, PaStream **s, const PaStreamParameters *inputParameters, const PaStreamParameters *outputParameters, double sampleRate, unsigned long framesPerBuffer, PaStreamFlags streamFlags, PaStreamCallback *streamCallback, void *userData)
PaError	IsStreamStopped (PaStream *s)
PaError	IsStreamActive (PaStream *stream)
PaTime	GetStreamTime (PaStream *stream)
double	GetStreamCpuLoad (PaStream *stream)
PaPulseAudio_HostApiRepresentation *	PaPulseAudio_New (void)
void	PaPulseAudio_Free (PaPulseAudio_HostApiRepresentation *ptr)
int	PaPulseAudio_CheckConnection (PaPulseAudio_HostApiRepresentation *ptr)
void	PaPulseAudio_CheckContextStateCb (pa_context *c, void *userdata)
void	PaPulseAudio_ServerInfoCb (pa_context *c, const pa_server_info *i, void *userdata)
void	PaPulseAudio_SinkListCb (pa_context *c, const pa_sink_info *l, int eol, void *userdata)
void	PaPulseAudio_SourceListCb (pa_context *c, const pa_source_info *l, int eol, void *userdata)
void	PaPulseAudio_StreamStateCb (pa_stream *s, void *userdata)
void	PaPulseAudio_StreamStartedCb (pa_stream *s, void *userdata)
void	PaPulseAudio_StreamUnderflowCb (pa_stream *s, void *userdata)
PaError	PaPulseAudio_ConvertPortaudioFormatToPaPulseAudio_ (PaSampleFormat portaudiosf, pa_sample_spec *pulseaudiosf)

Macro Definition Documentation

PA_PULSEAUDIO_DEFAULT_MAX_LATENCY

#define PA_PULSEAUDIO_DEFAULT_MAX_LATENCY   0.080

Referenced by PaPulseAudio_Initialize(), PaPulseAudio_SinkListCb(), and PaPulseAudio_SourceListCb().

PA_PULSEAUDIO_DEFAULT_MIN_LATENCY

#define PA_PULSEAUDIO_DEFAULT_MIN_LATENCY   0.010

Referenced by PaPulseAudio_Initialize(), PaPulseAudio_SinkListCb(), and PaPulseAudio_SourceListCb().

PA_PULSEAUDIO_IS_ERROR

#define PA_PULSEAUDIO_IS_ERROR	(		pastream,
			errorCode )

Value:

    if( !(pastream) || \
        !(pastream)->context || \
        !PA_CONTEXT_IS_GOOD( pa_context_get_state( (pastream)->context ) ) || \
        ( (pastream)->outputStream && \
        !PA_STREAM_IS_GOOD( pa_stream_get_state( (pastream)->outputStream ) ) ) || \
        ( (pastream)->inputStream && \
        !PA_STREAM_IS_GOOD( pa_stream_get_state( (pastream)->inputStream ) ) ) ) \
    { \
        if( !(pastream) || \
            ( (pastream)->context && \
              pa_context_get_state( (pastream)->context ) == PA_CONTEXT_FAILED ) || \
            ( (pastream)->outputStream && \
              pa_stream_get_state( (pastream)->outputStream ) == PA_STREAM_FAILED ) || \
            ( (pastream)->inputStream && \
               pa_stream_get_state( (pastream)->inputStream ) == PA_STREAM_FAILED ) ) \
            { \
                return errorCode; \
            } \
    } \
    if( !(pastream)->isActive || (pastream)->isStopped ) \
    { \
        return paStreamIsStopped; \
    }

Referenced by PaPulseAudio_ReadStreamBlock(), and PaPulseAudio_WriteStreamBlock().

PA_PULSEAUDIO_SET_LAST_HOST_ERROR

#define PA_PULSEAUDIO_SET_LAST_HOST_ERROR	(		errorCode,
			errorText )

Value:

    PaUtil_SetLastHostErrorInfo(paInDevelopment, errorCode, errorText)

Referenced by _PaPulseAudio_AddAudioDevice(), PaPulseAudio_BlockingInitRingBuffer(), PaPulseAudio_CheckContextStateCb(), PaPulseAudio_Free(), PaPulseAudio_Initialize(), PaPulseAudio_New(), PaPulseAudio_ServerInfoCb(), PaPulseAudio_SinkListCb(), PaPulseAudio_SourceListCb(), and PaPulseAudio_StreamStateCb().

PAPULSEAUDIO_FRAMESPERBUFFERUNSPEC

#define PAPULSEAUDIO_FRAMESPERBUFFERUNSPEC   32

Referenced by OpenStream().

PAPULSEAUDIO_MAX_DEVICECOUNT

#define PAPULSEAUDIO_MAX_DEVICECOUNT   1024

Referenced by _PaPulseAudio_AddAudioDevice(), and PaPulseAudio_Initialize().

PAPULSEAUDIO_MAX_DEVICENAME

#define PAPULSEAUDIO_MAX_DEVICENAME   1024

Referenced by _PaPulseAudio_AddAudioDevice(), PaPulseAudio_New(), PaPulseAudio_RenameSink(), and PaPulseAudio_RenameSource().

PULSEAUDIO_BUFFER_SIZE

#define PULSEAUDIO_BUFFER_SIZE   (96100 * 4 * 2)

Referenced by _PaPulseAudio_WriteRingBuffer().

Typedef Documentation

PaPulseAudio_Stream

typedef struct PaPulseAudio_Stream PaPulseAudio_Stream

Function Documentation

GetStreamCpuLoad()

double GetStreamCpuLoad

(

PaStream *

stream

)

References PaPulseAudio_Stream::cpuLoadMeasurer, and PaUtil_GetCpuLoad().

Referenced by PaPulseAudio_Initialize(), PaSkeleton_Initialize(), PaWasapi_Initialize(), PaWinMme_Initialize(), and PaWinWdm_Initialize().

GetStreamTime()

PaTime GetStreamTime

(

PaStream *

stream

)

References PaStreamCallbackTimeInfo::currentTime, PaPulseAudio_Stream::hostapi, PaPulseAudio_Stream::inputStream, PaPulseAudio_HostApiRepresentation::mainloop, PaPulseAudio_Stream::outputStream, PaPulseAudio_Lock(), PaPulseAudio_UnLock(), and PaPulseAudio_updateTimeInfo().

Referenced by PaPulseAudio_Initialize(), PaSkeleton_Initialize(), PaSndio_Initialize(), PaWasapi_Initialize(), PaWinMme_Initialize(), and PaWinWdm_Initialize().

IsFormatSupported()

PaError IsFormatSupported	(	struct PaUtilHostApiRepresentation *	hostApi,
		const PaStreamParameters *	inputParameters,
		const PaStreamParameters *	outputParameters,
		double	sampleRate )

References PaStreamParameters::channelCount, PaStreamParameters::device, PaUtilHostApiRepresentation::deviceInfos, PaStreamParameters::hostApiSpecificStreamInfo, PaDeviceInfo::maxInputChannels, PaDeviceInfo::maxOutputChannels, paCustomFormat, paFormatIsSupported, paIncompatibleHostApiSpecificStreamInfo, paInvalidChannelCount, paInvalidDevice, paSampleFormatNotSupported, paUseHostApiSpecificDeviceSpecification, and PaStreamParameters::sampleFormat.

Referenced by PaPulseAudio_Initialize(), PaSkeleton_Initialize(), PaSndio_Initialize(), PaWasapi_Initialize(), PaWinMme_Initialize(), and PaWinWdm_Initialize().

IsStreamActive()

PaError IsStreamActive

(

PaStream *

stream

)

References PaPulseAudio_Stream::isActive.

Referenced by PaPulseAudio_Initialize(), PaSkeleton_Initialize(), PaSndio_Initialize(), PaWasapi_Initialize(), PaWinMme_Initialize(), and PaWinWdm_Initialize().

IsStreamStopped()

PaError IsStreamStopped

(

PaStream *

s

)

References PaPulseAudio_Stream::isStopped.

Referenced by PaPulseAudio_Initialize(), PaSkeleton_Initialize(), PaSndio_Initialize(), PaWasapi_Initialize(), PaWinMme_Initialize(), and PaWinWdm_Initialize().

OpenStream()

PaError OpenStream	(	struct PaUtilHostApiRepresentation *	hostApi,
		PaStream **	s,
		const PaStreamParameters *	inputParameters,
		const PaStreamParameters *	outputParameters,
		double	sampleRate,
		unsigned long	framesPerBuffer,
		PaStreamFlags	streamFlags,
		PaStreamCallback *	streamCallback,
		void *	userData )

References PaPulseAudio_HostApiRepresentation::blockingStreamInterface, PaPulseAudio_Stream::bufferProcessor, PaPulseAudio_HostApiRepresentation::callbackStreamInterface, PaStreamParameters::channelCount, PaPulseAudio_HostApiRepresentation::context, PaPulseAudio_Stream::context, PaPulseAudio_Stream::cpuLoadMeasurer, PaStreamParameters::device, PaUtilHostApiRepresentation::deviceInfos, PaPulseAudio_Stream::framesPerHostCallback, PaPulseAudio_Stream::hostapi, PaStreamParameters::hostApiSpecificStreamInfo, PaPulseAudio_Stream::inputChannelCount, PaPulseAudio_Stream::inputDevice, PaPulseAudio_Stream::inputFrameSize, PaStreamInfo::inputLatency, PaPulseAudio_Stream::inputRing, PaPulseAudio_Stream::inputSampleSpec, PaPulseAudio_Stream::inputStream, PaPulseAudio_Stream::inputStreamName, PaPulseAudio_Stream::isActive, PaPulseAudio_Stream::isStopped, PaPulseAudio_HostApiRepresentation::mainloop, PaPulseAudio_Stream::mainloop, PaPulseAudio_Stream::maxFramesHostPerBuffer, PaPulseAudio_Stream::maxFramesPerBuffer, PaDeviceInfo::maxInputChannels, PaDeviceInfo::maxOutputChannels, PaPulseAudio_Stream::outputChannelCount, PaPulseAudio_Stream::outputDevice, PaPulseAudio_Stream::outputFrameSize, PaStreamInfo::outputLatency, PaPulseAudio_Stream::outputSampleSpec, PaPulseAudio_Stream::outputStream, PaPulseAudio_Stream::outputStreamName, PA_DEBUG, Pa_GetSampleSize(), paFloat32, paFramesPerBufferUnspecified, paIncompatibleHostApiSpecificStreamInfo, paInsufficientMemory, paInvalidChannelCount, paInvalidDevice, paInvalidFlag, paNoError, paPlatformSpecificFlags, PaPulseAudio_BlockingInitRingBuffer(), PaPulseAudio_ConvertPortaudioFormatToPaPulseAudio_(), PAPULSEAUDIO_FRAMESPERBUFFERUNSPEC, PaPulseAudio_Lock(), PaPulseAudio_StreamStartedCb(), PaPulseAudio_StreamStateCb(), PaPulseAudio_StreamUnderflowCb(), PaPulseAudio_UnLock(), paUnanticipatedHostError, paUseHostApiSpecificDeviceSpecification, PaUtil_AllocateZeroInitializedMemory(), PaUtil_FreeMemory(), PaUtil_GetBufferProcessorInputLatencyFrames(), PaUtil_GetBufferProcessorOutputLatencyFrames(), PaUtil_InitializeBufferProcessor(), PaUtil_InitializeCpuLoadMeasurer(), PaUtil_InitializeStreamRepresentation(), PaUtil_SelectClosestAvailableFormat(), paUtilUnknownHostBufferSize, PaPulseAudio_Stream::pulseaudioIsActive, PaPulseAudio_Stream::pulseaudioIsStopped, PaStreamParameters::sampleFormat, PaStreamInfo::sampleRate, PaUtilStreamRepresentation::streamInfo, PaPulseAudio_Stream::streamRepresentation, PaStreamParameters::suggestedLatency, and PaPulseAudio_Stream::suggestedLatencyUSecs.

Referenced by PaPulseAudio_Initialize(), PaSkeleton_Initialize(), PaSndio_Initialize(), PaWasapi_Initialize(), PaWinMme_Initialize(), and PaWinWdm_Initialize().

PaPulseAudio_CheckConnection()

int PaPulseAudio_CheckConnection

(

PaPulseAudio_HostApiRepresentation *

ptr

)

References PaPulseAudio_HostApiRepresentation::context, and PA_DEBUG.

Referenced by PaPulseAudio_Initialize().

PaPulseAudio_CheckContextStateCb()

void PaPulseAudio_CheckContextStateCb	(	pa_context *	c,
		void *	userdata )

References PaPulseAudio_HostApiRepresentation::mainloop, and PA_PULSEAUDIO_SET_LAST_HOST_ERROR.

Referenced by PaPulseAudio_New().

PaPulseAudio_ConvertPortaudioFormatToPaPulseAudio_()

PaError PaPulseAudio_ConvertPortaudioFormatToPaPulseAudio_	(	PaSampleFormat	portaudiosf,
		pa_sample_spec *	pulseaudiosf )

References PA_DEBUG, paCustomFormat, paFloat32, paInt16, paInt24, paInt32, paInt8, paNoError, paNonInterleaved, paSampleFormatNotSupported, and paUInt8.

Referenced by OpenStream().

PaPulseAudio_Free()

void PaPulseAudio_Free

(

PaPulseAudio_HostApiRepresentation *

ptr

)

References PaPulseAudio_HostApiRepresentation::allocations, PaPulseAudio_HostApiRepresentation::context, PaPulseAudio_HostApiRepresentation::mainloop, PaPulseAudio_HostApiRepresentation::mainloopApi, PA_PULSEAUDIO_SET_LAST_HOST_ERROR, PaUtil_DestroyAllocationGroup(), PaUtil_FreeAllAllocations(), PaUtil_FreeMemory(), and PaPulseAudio_HostApiRepresentation::timeEvent.

Referenced by PaPulseAudio_Initialize(), PaPulseAudio_New(), and Terminate().

PaPulseAudio_Initialize()

PaError PaPulseAudio_Initialize	(	PaUtilHostApiRepresentation **	hostApi,
		PaHostApiIndex	index )

PaPulseAudio_Lock()

void PaPulseAudio_Lock

(

pa_threaded_mainloop *

mainloop

)

References PA_DEBUG.

Referenced by _PaPulseAudio_WaitStreamState(), GetStreamTime(), OpenStream(), PaPulseAudio_CloseStreamCb(), PaPulseAudio_Initialize(), PaPulseAudio_ReadStreamBlock(), PaPulseAudio_ReleaseOperation(), PaPulseAudio_RenameSink(), PaPulseAudio_RenameSource(), PaPulseAudio_StartStreamCb(), PaPulseAudio_WriteStreamBlock(), and Terminate().

PaPulseAudio_New()

PaPulseAudio_HostApiRepresentation * PaPulseAudio_New

(

void

)

References __progname, PaPulseAudio_HostApiRepresentation::context, PaPulseAudio_HostApiRepresentation::deviceCount, PaPulseAudio_HostApiRepresentation::mainloop, PaPulseAudio_HostApiRepresentation::mainloopApi, PA_PULSEAUDIO_SET_LAST_HOST_ERROR, PaPulseAudio_CheckContextStateCb(), PaPulseAudio_Free(), PAPULSEAUDIO_MAX_DEVICENAME, and PaUtil_AllocateZeroInitializedMemory().

Referenced by PaPulseAudio_Initialize().

PaPulseAudio_ReleaseOperation()

void PaPulseAudio_ReleaseOperation	(	PaPulseAudio_HostApiRepresentation *	hostapi,
		pa_operation **	pulseaudioOperation )

References PaPulseAudio_HostApiRepresentation::mainloop, PA_DEBUG, PaPulseAudio_Lock(), and PaPulseAudio_UnLock().

Referenced by PaPulseAudio_CloseStreamCb(), PaPulseAudio_Initialize(), PaPulseAudio_RenameSink(), PaPulseAudio_RenameSource(), and PaPulseAudio_StartStreamCb().

PaPulseAudio_ServerInfoCb()

void PaPulseAudio_ServerInfoCb	(	pa_context *	c,
		const pa_server_info *	i,
		void *	userdata )

References PaPulseAudio_HostApiRepresentation::mainloop, PA_PULSEAUDIO_SET_LAST_HOST_ERROR, and PaPulseAudio_HostApiRepresentation::pulseaudioDefaultSampleSpec.

Referenced by PaPulseAudio_Initialize().

PaPulseAudio_SinkListCb()

void PaPulseAudio_SinkListCb	(	pa_context *	c,
		const pa_sink_info *	l,
		int	eol,
		void *	userdata )

References _PaPulseAudio_AddAudioDevice(), PaPulseAudio_HostApiRepresentation::mainloop, PA_PULSEAUDIO_DEFAULT_MAX_LATENCY, PA_PULSEAUDIO_DEFAULT_MIN_LATENCY, PA_PULSEAUDIO_SET_LAST_HOST_ERROR, and paNoError.

Referenced by PaPulseAudio_Initialize().

PaPulseAudio_SourceListCb()

void PaPulseAudio_SourceListCb	(	pa_context *	c,
		const pa_source_info *	l,
		int	eol,
		void *	userdata )

References _PaPulseAudio_AddAudioDevice(), PaPulseAudio_HostApiRepresentation::mainloop, PA_PULSEAUDIO_DEFAULT_MAX_LATENCY, PA_PULSEAUDIO_DEFAULT_MIN_LATENCY, PA_PULSEAUDIO_SET_LAST_HOST_ERROR, and paNoError.

Referenced by PaPulseAudio_Initialize().

PaPulseAudio_StreamStartedCb()

void PaPulseAudio_StreamStartedCb	(	pa_stream *	s,
		void *	userdata )

References PaPulseAudio_Stream::mainloop.

Referenced by OpenStream().

PaPulseAudio_StreamStateCb()

void PaPulseAudio_StreamStateCb	(	pa_stream *	s,
		void *	userdata )

References PA_DEBUG, and PA_PULSEAUDIO_SET_LAST_HOST_ERROR.

Referenced by OpenStream().

PaPulseAudio_StreamUnderflowCb()

void PaPulseAudio_StreamUnderflowCb	(	pa_stream *	s,
		void *	userdata )

References PaPulseAudio_Stream::mainloop, PaPulseAudio_Stream::outputUnderflows, and PA_DEBUG.

Referenced by OpenStream().

PaPulseAudio_UnLock()

void PaPulseAudio_UnLock

(

pa_threaded_mainloop *

mainloop

)

References PA_DEBUG.

Referenced by _PaPulseAudio_WaitStreamState(), GetStreamTime(), OpenStream(), PaPulseAudio_CloseStreamCb(), PaPulseAudio_Initialize(), PaPulseAudio_ReadStreamBlock(), PaPulseAudio_ReleaseOperation(), PaPulseAudio_RenameSink(), PaPulseAudio_RenameSource(), PaPulseAudio_StartStreamCb(), PaPulseAudio_WriteStreamBlock(), and Terminate().

Terminate()

void Terminate

(

struct PaUtilHostApiRepresentation *

hostApi

)

References PaPulseAudio_HostApiRepresentation::context, PaPulseAudio_HostApiRepresentation::mainloop, PaPulseAudio_Free(), PaPulseAudio_Lock(), and PaPulseAudio_UnLock().

Referenced by PaPulseAudio_Initialize(), PaSkeleton_Initialize(), PaSndio_Initialize(), PaWasapi_Initialize(), PaWinMme_Initialize(), and PaWinWdm_Initialize().