|
DTWAIN_GetSourceAcquisitions |
Top Previous Next |
|
The DTWAIN_GetSourceAcquisitions gets a Source's acquisitions that have been attempted.
DTWAIN_ARRAY DTWAIN_GetSourceAcquisitions ( DTWAIN_SOURCE Source );
Parameters Source Specifies a TWAIN Source.
Return Values If the function succeeds, a DTWAIN_ARRAY describing the attempted acquisitions is returned. If the function succeeds If the function fails, NULL is returned.
Comments The DTWAIN_GetSourceAcquisitions function returns the array of acquisition attempts that the Source has made. This function is usually used to get all of the acquisitions for a DTWAIN Modeless acquisition. The return value for this function is the same return value for DTWAIN_AcquireNative and DTWAIN_AcquireBufferedwhen acquiring images using DTWAIN Modal processing. Included in the array of acquisitions are arrays of all of the image data (DIBs or raw images) that have been acquired, therefore the return value for DTWAIN_GetSourceAcquisitions can be used as the first parameter in functions such as DTWAIN_GetAcquiredImageArray and DTWAIN_GetAcquiredImage.
DTWAIN_MODELESS If the Twain mode is DTWAIN_MODELESS, your application should trap the DTWAIN_TN_ACQUIREDONE notification to retrieve the acquired DIBs. The DTWAIN_GetSourceAcquisitions function is used to get all of the acquired DIBs from the Source.
TWAIN State Transitions State 4 (if Source is not opened)
Prerequisite Function Call(s)
DTWAIN Source Selection Function
See Also |