RtGVWaitForFrame

RtGVWaitForFrame waits for the first packet of a frame to be received.

Syntax

BOOL RtGVWaitForFrame(
	HANDLE cameraHandle, 
	UINT32 msTimeout
);

Parameters

cameraHandle

The handle of the camera from which a frame is expected.

msTimeout

The length of time, in milliseconds, to wait for the first packet of a frame to be received.

Return Values

Returns TRUE when a frame has begun being transmitted to the RTX64 GigE Vision NIC. Returns FALSE otherwise. Call GetLastError for extended error information.

Remarks

This function should be used when RtGVGrabFrame returns FALSE with error RTGV_ERROR_NO_IMAGE.

Once this function returns TRUE, next call RtGVGrabFrame.

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 4.1 Vision SDK
Header	RtGVApi.h
Library	RtGigEVision.lib