F_VN_ExportSubContainer
Export the container elements of a sub-container into a buffer (e.g. an array). Only possible for 2-dimensional containers with basic elements.
Syntax
Definition:
FUNCTION F_VN_ExportSubContainer : HRESULT
VAR_INPUT
ipContainer : ITcVnContainer;
nIndex : ULINT;
pBuffer : PVOID;
nBufferSize : ULINT;
hrPrev : HRESULT;
END_VAR
Inputs
|
Name |
Type |
Description |
|---|---|---|
|
ipContainer |
Container with basic elements | |
|
nIndex |
ULINT |
Index of the requested element |
|
pBuffer |
PVOID |
Buffer to store the container elements (Make sure to allocate enough memory! The required size in bytes can be determined using the function F_VN_ExportSubContainerSize) |
|
nBufferSize |
ULINT |
Size of the buffer memory in bytes |
|
hrPrev |
HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) |
Return valueRelated functions
Required License
TC3 Vision Base
System Requirements
Development environment | Target platform | PLC libraries to include |
|---|---|---|
TwinCAT V3.1.4024.54 or later | PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU | Tc3_Vision |