Description

Retrieves the name of the XML file to use for the camera. If the XML file has not yet been downloaded from the camera, it is downloaded  and stored in the subdirectory 'xml/<manufacturer>' of the installation  directory pointed to by the GIGEV_XML_DOWNLOAD  environment variable.

If the GIGEV_XML_DOWNLOAD environment variable is not set, the XML file is stored in the 'xml/<manufacturer>' subdirectory of the program executing.

Generally, once the XML file is already on the local disk, it is not  downloaded again. If the "force_download" flag is set, the XML file is  downloaded, regardless of whether it is on the disk or not.

Parameters

handle

Handle to the camera.

filename

Pointer to a string to receive the XML file name (as stored in the camera)

size

Number of bytes available to store the file name in the filename string.

force_download

If TRUE, the XML file is always downloaded from the camera overwriting the file on disk.

If FALSE, the XML file is downloaded from the camera only if it does not exist on disk.

Return Value

GEVLIB_OK on success.