Changeset 27

Show
Ignore:
Timestamp:
08/29/02 12:42:21 (6 years ago)
Author:
rossbencina
Message:

moved old IsFormatSupported? signature into the Discussion section

Files:
1 modified

Legend:

Unmodified
Added
Removed
  • pa_proposals/trunk/002-ImproveDeviceFormatsQueryInterface.html

    r23 r27  
    3737 
    3838<P> 
    39 The PaDeviceInfo structure and Pa_GetDeviceInfo() function will be retained to provide simple  
     39The existing (V18) PaDeviceInfo structure and Pa_GetDeviceInfo() function will be retained to provide simple  
    4040attribute information about the device such as it's name, and for representing information  
    4141that can be obtained without querying the host API multiple times, such as input and output channel counts: 
     
    7272#define paFormatIsSupported (0) 
    7373 
    74 PaError Pa_IsFormatSupported( PaDeviceIndex inputDevice,  
    75                         int numInputChannels,  
    76                         PaSampleFormat inputSampleFormat, 
    77                         void *inputDriverInfo,  
    78                         PaDeviceIndex outputDevice,  
    79                         int numOutputChannels,  
    80                         PaSampleFormat outputSampleFormat,  
    81                         void *outputDriverInfo,  
    82                         double sampleRate ); 
    83 </PRE> 
    84  
    85 <P> 
    86 The <A href="016-UseStructsForOpenStreamParameters.html">Use Structs for Pa_OpenStream() Parameters</A> proposal defines 
    87 the PaStreamParameters structure which will replace the individual parameters in the Pa_IsFormatSupported() definition above, 
    88 resulting in the following prototype: 
    89 </P> 
    90  
    91 <PRE> 
    9274PaError Pa_IsFormatSupported( 
    9375   PaStreamParameters *inputParameters, 
     
    9678</PRE> 
    9779 
     80<P> 
     81The <A href="016-UseStructsForOpenStreamParameters.html">Use Structs for Pa_OpenStream() Parameters</A> proposal defines 
     82the PaStreamParameters structure which is used to pass device, number of channels and sample format information to Pa_IsFormatSupported().  
     83</P> 
    9884 
    9985 
     
    132118<P> 
    133119Although the retention of maxInputChannels and maxOutputChannels in the PaDeviceInfo 
    134 structure is considered desirable by some clients, it has not yet been 
     120structure is considered desirable by some clients, it has not been 
    135121determined whether implementation of this feature is practical without polling  
    136122some host APIs multiple times. 
     
    146132</P> 
    147133 
     134 
     135<P> 
     136Prior to the definition of the PaStreamParameters struct in the  
     137<A href="016-UseStructsForOpenStreamParameters.html">Use Structs for Pa_OpenStream() Parameters</A> 
     138proposal, the following signature was proposed for Pa_IsFormatSupported(): 
     139</P> 
     140 
     141<PRE> 
     142PaError Pa_IsFormatSupported( PaDeviceIndex inputDevice,  
     143                        int numInputChannels,  
     144                        PaSampleFormat inputSampleFormat, 
     145                        void *inputDriverInfo,  
     146                        PaDeviceIndex outputDevice,  
     147                        int numOutputChannels,  
     148                        PaSampleFormat outputSampleFormat,  
     149                        void *outputDriverInfo,  
     150                        double sampleRate ); 
     151</PRE> 
     152 
     153 
    148154<H4>Impact Analysis</H4> 
    149155