Returns all default parameter values for a given parameter structure.

DWORD adiGetParms( unsigned parmid,
void *buffer,
unsigned size )

parmid Parameter structure ID.

buffer Buffer to receive parameter values.

size Size of buffer.

• SUCCESS
• CTAERR_BAD_SIZE
  size is less than the parameter size.
• CTAERR_BAD_ARGUMENT
  parmid is 0; buffer is NULL.
• CTAERR_NOT_FOUND
  parmid not found.
• CTAERR_SHAREMEM_ACCESS

None.

This function retrieves the default parameter values for the structure identified by its parmid. AG Access writes these values to the address specified in buffer. The size argument specifies the amount of available memory at the address and must be large enough to contain the returned parameter structure.

adiGetParmByName, adiGetParmInfo, adiConfigParm

DWORD myPlayFromMemory( CTAHD ctahd, unsigned encoding,
                        void *buffer, unsigned bufsize, unsigned gain )
{
    ADI_PLAY_PARMS playparms;

    adiGetParms( ADI_COLLECT_PARMID, &playparms, sizeof playparms );
    playparms.gain = gain;

    return adiPlayFromMemory( ctahd, encoding, buffer, bufsize, &playparms );
}