RtGVStartStream

RtGVStartStream combines the functionality of both RtGVStartReceiveStream and RtGVStartCameraStream.

Syntax

BOOL RtGVStartStream(
	HANDLE cameraHandle,       
	UINT32 localIP, 
	UINT32 localPort, 
	UINT32 imageRingBufferNumElements
	HANDLE * StreamErrorEvent
);

Parameters

cameraHandle

A handle to the camera for which a stream will be started.

localIPAddress

The IP Address of the RTX64 Network Interface Card (NIC) to which the camera should send images.

localPort

The local port to which the camera should send images.

imageRingBufferNumElements

The number of elements to be allocated for the image ring buffer, which holds images which have been received and are ready to be grabbed using RtGVGrabFrame.  When in trigger mode, only 1 element is needed. In continuous mode, a larger ring buffer is recommended. A ring buffer size of 10 has been tested and is known to work.

streamErrorEvent

A pointer to an event handle that will be signaled if an error occurs in the stream.

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 and RtGVInitCameraControl.

To find the camera to query, call RtGVInitialize and then call RtGVEnumerateCameras to get an RTGV_CAMERA_INFO array describing each of the cameras found on the network, along with each of their handles.

Requirements

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