RtgvSharedBufferGetEmptyFrame

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

Syntax

PRTGV_FRAME RtgvSharedBufferGetEmptyFrame(
    [in]    HANDLE hBuffer
);

Parameters

[in] 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 to obtain an error code.

Remarks

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

Requirements