Resettransferhardwareicmedia, Synchronizedpowerdownicmedia, Unbindphysicalmemoryfromvirtualmemoryicmedia – Hand Held Products 4X00 Series User Manual

Page 18: Waitforvsyncicmedia

Advertising
background image

12

IMAGETEAM™ 4X00 Series Hardware Interface Layer Specification

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.

Advertising