L_DicomWaveGrpSaveAudio

#include "Ltdic.h"

L_LTDIC_API L_UINT16 L_DicomWaveGrpSaveAudio(hDICOMWaveFormGroup, pszFilename, uFlags)

HDICOMWAVEFORMGROUP hDICOMWaveFormGroup;	/* a DICOM waveform group handle*/
L_TCHAR * pszFilename;	/* file name */
L_UINT16 uFlags;	/* reserved for future use */

Creates an audio (wave) file from the channels in the waveform group.

Parameter

Description

hDICOMWaveFormGroup	A DICOM waveform group handle
pszFilename	Name of the audio file to be created.
uFlags	Reserved for future use. Pass 0.

Returns

DICOM_SUCCESS	The function was successful.
> 0	An error occurred. Refer to Return Codes.

Comments

This function is very useful for extracting audio (wave) data from a DICOM object of type "Basic Voice Audio" (1.2.840.10008.5.1.4.1.1.9.4.1), which is typically used for report dictation.

The resulting wave file has the following characteristics:

1.	Number of channels: will either be 1 or 2, based on the value of the number of channels for this multiplex group. You can call L_DicomWaveGrpGetNumberOfChannels to get the number of channels in a multiplex group.
2.	Bits per sample (sample size) will always be 8.
3.	Samples per second (sampling rate): This will be the same as the sampling frequency for the waveform group, call L_DicomWaveGrpGetSamplingFrequency to get this value.
4.	Format category: PCM, mu-Law or a-Law, based on the value of the waveform sample interpretation which can be retrieved by calling L_DicomWaveGrpGetSampleInterpretation.

Required DLLs and Libraries

LTDIC

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application

Platforms

Win32, x64