RtgvWaitForFrame

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

Syntax

BOOL RtgvWaitForFrame(
    [in]    HANDLE cameraHandle, 
    [in]    UINT32 msTimeout
);

Parameters

[in] cameraHandle

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

[in] 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 wRTOS GigE Vision NIC. Otherwise, it returns FALSE. Call GetLastError to obtain an error code.

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 camera found on the network, along with its handles.

Requirements