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

See Also

Functions:

L_DicomWaveGrpLoadAudio

Topics:

Working with DICOM Waveforms

Example

// The following sample shows how to extract a