Determine whether or not a page is loaded in the scanner.

Declaration:

AT_ERRCOUNT ACCUAPI IG_ISIS_drv_is_page_loaded(
        HISISDRV hDriver,
        AT_LMODE lFlags,
        LPAT_LMODE lpResult
);

Arguments:

Return Value:

Returns the number of ImageGear errors that occurred during this function call. If there are no errors, the return value is IGE_SUCCESS.

Supported Raster Image Formats:

This function does not process image pixels.

Example:

The following example checks the scanner to determine whether or not it can report whether there is a page in the feeder, and then checks to see whether or not a page is loaded:

DWORD dwBits;IG_ISIS_tag_get_long(hDriver, IG_ISIS_TAGIG_ISIS_TAG_FEEDER, 0, &dwBits);
if (dwBits & IG_ISIS_FEEDER_TELLFEED) {IG_ISIS_drv_is_page_loaded(hDriver, IG_ISIS_FEEDER_FEED, &dwBits);
        if (dwBits & IG_ISIS_DRV_STACKPAGE);
                printf("There is a page ready in the feeder.");
        else
                printf("The feeder is empty.");
}
else
        printf("Can't tell if page is present.");

Remarks:

The IG_ISIS_drv_is_page_loaded function checks to see whether or not a page is loaded on the scanner's flatbed or feeder (assuming the scanner supports this query).

IG_ISIS_drv_is_page_loaded queries a scanner driver and reports whether or not a page is loaded. Before using IG_ISIS_drv_is_page_loaded, you must include code that uses IG_ISIS_tag_get_long to determine the scanner's capabilities, as shown in the example below. If the scanner does not support telling whether or not a page is loaded in the feeder (when IG_ISIS_FEEDER_TELLFEED = FALSE), then lpdwResult will give zero (0) (can't tell if page is loaded).

The current implementation handles scanners with flatbed page sensors and feeder stack sensors. Future implementations may be enhanced with additional flags to handle hand scanners, frame grabbers, and other devices.

See Also:

IG_ISIS_tag_get_long