Bindphysicalmemorytovirtualmemoryicmedia, Captureinitiatedicmedia, Deinitializeimagelinedataprocessingicmedia – Hand Held Products 4X00 Series User Manual

Page 9: Deinitializevsyncprocessingicmedia

Advertising
background image

IMAGETEAM™ 4X00 Series Hardware Interface Layer Specification

3

BindPhysicalMemoryToVirtualMemoryICMedia

This function binds the physical memory of an image, specified by "hPhysical," to a virtual memory location specified by
"pVirtual."

Note: It is possible that multiple calls to this function may be made with the same physical pseudo-handle, but a different virtual

address, i.e., binding multiple virtual addresses to the same physical space at the same time. This is normal.

DWORD BindPhysicalMemoryToVirtualMemoryICMedia(

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 to be bound to the physical memory referenced by
hPhysical.

Returns

Zero on failure, non-zero on success.

CaptureInitiatedICMedia

In order to stay synchronized with the incoming images, the scan driver needs to know when each request to acquire a new image
has been successfully completed. A request for a new capture that is made before the front edge of the Vsync signal (an optional
function) should be carried out on the front edge of the next Vsync signal. CaptureInitiatedICMedia is called after the front edge
of Vsync to determine if that has happened.

DWORD CaptureInitiatedICMedia(

void
)

Returns

Zero indicates that on the last front edge of Vsync a new capture request was not carried out. This will occur either

because the requet was never made, or because the request was made but was unsuccessful.

Non-zero indicates that a new capture request was carried out on the last front edge of Vsync.

DeinitializeImageLineDataProcessingICMedia

This function is used to destroy, or undo any software or hardware configurations that are associated with the calling of the image
data line processing.

DWORD DeinitializeImageLineDataProcessingICMedia(

void
)

Returns

Zero on failure, non-zero on success.

DeinitializeVsyncProcessingICMedia

This function disables the system from responding to the Vsync pulse from the imager. This involves undoing the setup
performed via the

InitializeVsyncProcessingICMedia

(see page 10), function.

DWORD DeinitializeVsyncProcessingICMedia(

void
)

Advertising