Hand Held Products 4X00 Series manual ResetTransferHardwareICMedia, SynchronizedPowerDownICMedia

Page 18

Returns

None.

ResetTransferHardwareICMedia

This function stops a transfer that is either ready to run, or currently running. It also resets the system making it ready for the next call to InitCaptureICMedia.

void ResetTransferHardwareICMedia(

void

)

Returns

None.

SynchronizedPowerDownICMedia

This function puts the imager in power down mode upon receiving the next front edge of Vsync. The IC Media imager freezes when it goes into power down mode, so one of the checks after the power down is to make sure the Vsync is in the "between frames" state (in down time), since that’s where the IC Media camera should be frozen.

BOOL SynchronizedPowerDownICMedia()

Returns

Non-zero if successfully powered down in the down time.

UnBindPhysicalMemoryFromVirtualMemoryICMedia

This function unbinds the physical memory of an image, specified by "hPhysical," from the virtual memory location specified by "pVirtual." This does not, however, free any memory. The "pVirtual" pointer should still be a valid pointer pointing to RESERVED but not COMMITTED memory, and the physical memory should still be available for future bindings.

DWORD UnBindPhysicalMemoryFromVirtualMemoryICMedia(

DWORD hPhysical, void *pVirtual

)

Passed Arguments

Description

DWORD hPhysical

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

 

returned by AllocatePhysicalScanSpaceICMedia when the space was allocated.

void *pVirtual

A pointer to a virtual address.

Returns

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

WaitForVsyncICMedia

This function waits until the imager sees the front edge of the Vsync, then it returns. Since many systems involve threads going to sleep waiting for this event to occur, a safety check on the way out of this function is to see if the Vsync reflects the camera being "between frames" (down time).

BOOL WaitForVsyncICMedia()

Returns

Non-zero on successful synchronization to the Vsync before returning.

12

IMAGETEAM™ 4X00 Series Hardware Interface Layer Specification

Image 18
Contents User’s Guide Disclaimer FCC/CELaser Eye Safety Statement for IT4300 Series Engines IT4300 is intended for use in CDRH/IEC Class 2 devicesPage Table of Contents Page OEM API Layer Design OverviewUser Layer Image Acquisition LayerAimOffICMedia Alphabetic Function ListAimIsOnICMedia AimOnICMediaDeinitializeImageLineDataProcessingICMedia BindPhysicalMemoryToVirtualMemoryICMediaCaptureInitiatedICMedia DeinitializeVsyncProcessingICMediaEnableImageLineDataProcessingICMedia DisableImageLineDataProcessingICMediaDisableVsyncInterruptICMedia EnableVsyncInterruptICMediaFreePhysicalScanSpaceICMedia GetFrequencyPerFrameOfLineDataCallbackICMediaGetHardwareDllRevisionICMedia Bool GetImagerPropertiesICMedia GetImagerPropertiesICMediaGetNumberOfValidRowsICMedia Dword GetNumberOfValidRowsICMediaGetScanWidthICMedia GetRegisterSettingsForHHPExposureControlICMediaGetScanHeightICMedia IllumIsOnICMediaImagerPowerOffAndSuspendICMedia ImagerIsPoweredICMediaImagerPowerDownICMedia IllumOffICMediaImagerPowerOnAndResumeICMedia ImagerPowerUpICMediaInDownTimeICMedia InitCaptureICMedia InitializeImageLineDataProcessingICMediaInitializeVsyncProcessingICMedia RegisterImageLineDataNotificationICMedia RequestSynchronizedPowerDownICMediaReadIICICMedia RegisterVsyncNotificationICMediaUnBindPhysicalMemoryFromVirtualMemoryICMedia ResetTransferHardwareICMediaSynchronizedPowerDownICMedia WaitForVsyncICMediaWaitMillisecondsICMedia WriteIICICMediaVoid WaitMillisecondsICMedia Dword nTime Programming Notes Technical Assistance Online Technical AssistanceImageteam 4X00 Series Hardware Interface Layer Specification Page Hand Held Products, Inc