RtGVSharedBufferGetEmptyFrame

RtGVSharedBufferGetEmptyFrame retrieves an empty frame from the list of empty frames associated with the shared buffer.

Syntax

PRTGV_FRAME RtGVSharedBufferGetEmptyFrame(
	HANDLE hBuffer
);

Parameters

hBuffer

A handle to the buffer from which the empty frame will be retrieved.

Return Values

Returns a pointer to an empty image that can be filled with metadata and image data, if it succeeds.  Otherwise, it returns NULL.  Call GetLastError for extended error information.

Remarks

The empty image can be filled with metadata and image data retrieved through calls into a 3rd party vision library layered on top of RtVision.  This image can then be pushed onto the end of the shared buffer by calling RtGVSharedBufferPush.

Requirements

Minimum Supported Version RTX64 3.7 SDK

Header

RtGVComm.h

Library

RtGVComm.lib

See Also:

RtGVCreateSharedBuffer

RtGVOpenSharedBuffer

RtGVSharedBufferPush

RtGVSharedBufferPushToEmptyList