DTWAIN_AcquireAudioFile

DTWAIN_AcquireAudioFileA

DTWAIN_AcquireAudioFileW

The DTWAIN_AcquireAudioFile function starts the acquisition of images from a TWAIN Source using the Audio file transfer method.

DTWAIN_BOOL DTWAIN_AcquireAudioFile (

DTWAIN SOURCE	Source,
LPCTSTR	FileName,
LONG	FileControlFlag,
LONG	MaxAudioClips,
DTWAIN_BOOL	bShowUI,
DTWAIN_BOOL	bCloseSource,
LPLONG	pStatus );

Parameters

Source

Specifies a selected TWAIN Source.

FileNames

Points to a null terminated string denoting the audio file name.

FileControlFlag

Specifies user interaction and which transfer mode to use.

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

TRUE if successful, FALSE otherwise.

Character specific version

ANSI version:	DTWAIN_AcquireAudioFileA
Unicode version:	DTWAIN_AcquireAudioFileW

Comments

DTWAIN_AcquireAudioFile allows an application to acquire audio files 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_FILE.

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