RtGVEnumerateCameras

RtGVEnumerateCameras enumerates the discovered cameras on the network.

Syntax

BOOL RtGVEnumerateCameras(
 	PRTGV_CAMERA_INFO pCameraInfo, 
 	DWORD          NumElements,
 	PDWORD         pNumElementsNeeded,
 	UINT32         localIP,
 	UINT32         localPort,
 	UINT32         msTimeout
 ); RtGVEnumerateCamerasA, RtGVEnumerateCamerasW

Parameters

pCameraInfo

An array that receives the list of RTGV_CAMERA_INFO objects.  If this is NULL, the value pointed to by pNumElementsNeeded is set to the number needed.

pNumElements

A value that specifies the number of elements in the array pointed to by pCameraInfo.  If this number is not high enough, pNumElementsNeeded is set to the number of elements needed and last error is set to ERROR_INSUFFICIENT_BUFFER.

pNumElementsNeeded

A pointer to a DWORD that, upon success of this function, receives the number of cameras returned by the function.  This can then be used to parse through the elements of pCameraInfo.

localIP

The local IPv4 IP used to discover cameras.

localPort

The local port used to discover cameras.

msTimeout

The amount of time to wait for a response from the camera(s) on the network. The default timeout is 2000.

Return Values

Returns TRUE if the function succeeds, FALSE if the function fails. Call GetLastError for extended error information.

Remarks

This function will fail if it is called before RtGVInitialize.

This function should be called to select the camera you wish to use.

Requirements

Minimum Supported Version	RTX64 4.1 Vision SDK
Header	RtGVApi.h
Library	RtGigEVision.lib