Hand Held Products 4X00 Series manual FreePhysicalScanSpaceICMedia, GetHardwareDllRevisionICMedia

Page 11

FreePhysicalScanSpaceICMedia

This function frees the physical memory for a single image.

DWORD FreePhysicalScanSpaceICMedia(

DWORD hImage

)

Passed Arguments

Description

DWORD hImage

A "pseudo-handle" to a reserved physical memory slot. This was the value returned by

 

AllocatePhysicalScanSpaceICMedia when the space was allocated.

Returns

DWORD - This function returns non-zero on success, zero on failure.

GetFrequencyPerFrameOfLineDataCallbackICMedia

This function returns the number of calls made to the image line data callback function during each frame. When using an operating system such as Windows CE, it may be difficult to tell consistently how many callbacks may be made per frame. In that case, make a low estimate. Therefore, if on a given system the callback may be called from 28-33 times, a safe number would be 27.

DWORD GetFrequencyPerFrameOfLineDataCallbackICMedia(

void

)

Returns

A number 'N' that completes this statement, "the line processing occurs at least 'N' times per frame."

GetHardwareDllRevisionICMedia

This function returns a revision number of the hardware DLL. The functions included with any given revision of the hardware DLL are determined by this number. This guarantees that if the Image Acquisition Layer driver software is updated, but a hardware DLL has not been updated, the software will be backward compatible. This document represents what should be included in revision 1 of the hardware DLL.

Note: This function can be used as a general hardware layer initialization function since it is only called by the scan driver one time, and it does not have the limitations of a base DLL initialization (for example, it can’t call Win32 API functions).

DWORD GetHardwareDllRevisionICMedia(

void

)

Returns

Revision number of the hardware DLL.

IMAGETEAM™ 4X00 Series Hardware Interface Layer Specification

5

Image 11
Contents User’s Guide FCC/CE DisclaimerIT4300 is intended for use in CDRH/IEC Class 2 devices Laser Eye Safety Statement for IT4300 Series EnginesPage Table of Contents Page Image Acquisition Layer Design OverviewUser Layer OEM API LayerAimOnICMedia Alphabetic Function ListAimIsOnICMedia AimOffICMediaDeinitializeVsyncProcessingICMedia BindPhysicalMemoryToVirtualMemoryICMediaCaptureInitiatedICMedia DeinitializeImageLineDataProcessingICMediaEnableVsyncInterruptICMedia DisableImageLineDataProcessingICMediaDisableVsyncInterruptICMedia EnableImageLineDataProcessingICMediaGetHardwareDllRevisionICMedia FreePhysicalScanSpaceICMediaGetFrequencyPerFrameOfLineDataCallbackICMedia Dword GetNumberOfValidRowsICMedia GetImagerPropertiesICMediaGetNumberOfValidRowsICMedia Bool GetImagerPropertiesICMediaIllumIsOnICMedia GetRegisterSettingsForHHPExposureControlICMediaGetScanHeightICMedia GetScanWidthICMediaIllumOffICMedia ImagerIsPoweredICMediaImagerPowerDownICMedia ImagerPowerOffAndSuspendICMediaInDownTimeICMedia ImagerPowerOnAndResumeICMediaImagerPowerUpICMedia InitializeVsyncProcessingICMedia InitCaptureICMediaInitializeImageLineDataProcessingICMedia RegisterVsyncNotificationICMedia RequestSynchronizedPowerDownICMediaReadIICICMedia RegisterImageLineDataNotificationICMediaWaitForVsyncICMedia ResetTransferHardwareICMediaSynchronizedPowerDownICMedia UnBindPhysicalMemoryFromVirtualMemoryICMediaVoid WaitMillisecondsICMedia Dword nTime WaitMillisecondsICMediaWriteIICICMedia Programming Notes Online Technical Assistance Technical AssistanceImageteam 4X00 Series Hardware Interface Layer Specification Page Hand Held Products, Inc