DTWAIN_AcquireAudioNative

Top  Previous  Next

The DTWAIN_AcquireAudioNative function starts the acquisition of audio clips from a TWAIN Source using the Audio file transfer method.  The audio clip(s) are returned in a DTWAIN_ARRAY.

 

DTWAIN_ARRAY  DTWAIN_AcquireAudioNative (

DTWAIN SOURCE

Source,

LONG

MaxAudioClips,

DTWAIN_BOOL

bShowUI,

DTWAIN_BOOL

bCloseSource,

LPLONG

pStatus );

 

Parameters

Source

Specifies a selected TWAIN Source.

 

MaxAudioClips

Specifies the maximum number of audio clips to acquire

 

bShowUI

Specifies whether the Source displays the default User Interface.

 

bCloseSource

Specifies whether the Source should be automatically closed when the User Interface is closed.

 

pStatus

NULL, or is the address of a variable that will be filled in with an error status value. 


Return Values

If the function succeeds and the Twain Mode is DTWAIN_MODAL, a DTWAIN_ARRAY describing the attempted acquisitions is returned.  If the function succeeds and the Twain mode is DTWAIN_MODELESS, a non-zero value is returned. If the function fails, NULL is returned.

 

Comments

DTWAIN_AcquireAudioNative allows an application to acquire audio clips from the TWAIN device.  Note that the device must support the generation of audio data.  To test if a device supports audio file transfers, use DTWAIN_IsAudioXferSupported with a transfer type of TWSX_NATIVE.


The format for the audio clips are in the WAV format.  Thus the DTWAIN_ARRAY will contain handles to WAV format.  Note that the DTWAIN_GetAcquiredImage, DTWAIN_GetAcquiredImageArray can be used to retrieve the WAV file information.  


TWAIN State Transitions

State 4(if Source is not opened)

State 5, 6, 7

State 4 (if Source is closed after acquisitions)

 

Prerequisite Function Call(s)

DTWAIN_SysInitialize

DTWAIN Source Selection Function

 

See Also

Acquiring Images