int sm_record_wav_bf_start(char *filename, SM_BFILE_RECORD_PARMS *file_parms)
Creates file with given name, allocates space in file by writing blank WAV file header, sets up fd in structure pointed at by file_parms and then invokes sm_record_bfile_start.
The other elements of the record_parms. structure must be set up as for sm_record_bfile_start. The setting of the record_parms.type, parameter will determine type of WAV file created.
Note it is the responsibility of the application to close the file following record completion or abort using sm_record_wav_bf_close().
0 if call completed successfully, otherwise a standard error such as:
This function is part of the Prosody WAV BFILE API.