Loading Reference... User Guide... Hardware-specific Notes...

Customize Help

MIL systems:
Show All

Installed MIL systems

Multiple

None

Host system

Matrox GigE Vision driver (MIL 10, Update 25, Update 54, or Update 85)*

Matrox Morphis

Matrox Morphis QxT

Matrox Orion HD

Matrox Radient eCL

Matrox Radient eV-CXP (MIL 10 or Update 29)*

Matrox Solios eA/XA

Matrox Solios ecl/xcl/ev-cl

Matrox USB3 Vision driver (Update 19)

Matrox RadientPro-CL (Update 7)

Matrox Radient eV-CL (Update 27 or 74)

Matrox Iris GTR (Update 28 or Update 68)

Matrox Clarity UHD (Update 36 or 76)

Matrox GenTL driver (Update 34)

Matrox Indio (Update 53 or Update 68)

Matrox Rapixo CXP (Update 75 or Update 84)

Matrox Concord PoE with ToE (Update 82)

Matrox Rapixo CL Pro (Update 96)

As Tooltip

Value descriptions: Detailed Summarized

Save Settings

MbufLink

See also

Reference:

MbufAllocContainer MbufConvert3d

Availability

Available in MIL-Lite

Available in MIL

Available on Windows

Available on Linux

Available on Non-Matrox computer

Available on Matrox 4Sight-X

Available on Matrox 4Sight GP/GPm

Available on Matrox Supersight

Function map

Examples

monitoringapplication.cpp
monitoringapplication.cs

Function Map

- SrcContainerOrBufId

- TargetContainerOrBufId

- LinkOperation

Table:

To specify the link operation

- ControlFlag

Table:

For specifying to compensate for missing information in the source container

Compilation information

Synopsis

Link one buffer or container to another.

Syntax

void MbufLink(

MIL_ID SrcContainerOrBufId,	//in
MIL_ID TargetContainerOrBufId,	//in
MIL_INT64 LinkOperation,	//in
MIL_INT ControlFlag	//in

)

Description

This function links two buffers or containers so that subsequent modifications in the source are copied to the target until the buffers/containers are unlinked. For instance, when using the Distributed MIL monitoring configuration, you can link a publishing application's image buffer to the monitoring application's image buffer. Any modifications to the published buffer will be copied to the local buffer.

Note that this function reference has not been updated for a MIL system added during a MIL update. Refer to the MIL system's release note to see if there is complementary information.

Parameters

This function is not supported on the selected boards.

Parameters

SrcContainerOrBufId

Specifies the identifier of the source buffer or container. This buffer or container remains independent and can be modified as per the application's standard mechanisms.

TargetContainerOrBufId

Specifies the identifier of the target buffer or container. The contents of this buffer or container will have the same modifications applied to it as are applied to SrcContainerOrBufId.

LinkOperation

Specifies the link operation to perform.

To specify the link operation
Value	Description
M_LINK	Specifies to link the two specified buffers.
M_UNLINK	Specifies to unlink the two specified buffers.

ControlFlag

Specifies whether to convert 3D information copied from the source container. If unused, this parameter must be set to M_DEFAULT.

For specifying to compensate for missing information in the source container
Value	Description
M_COMPENSATE	Specifies to automatically convert the information copied from the source container to the destination container so that the destination container is 3D-processable (if the destination container has the attribute M_PROC) and/or 3D-displayable (if the destination container has the attribute M_DISP). This is equivalent to using MbufConvert3d() with M_COMPENSATE. An error will be generated any time the source container is modified and its contents cannot be copied because it cannot be converted. Note that this setting is only available when mil3d.dll is present. (summarize) Specifies to automatically convert the information copied from the source container to the destination container so that the destination container is 3D-processable (if the destination container has the attribute M_PROC) and/or 3D-displayable (if the destination container has the attribute M_DISP). (more details...)

Compilation information

Header	Include mil.h.
Library	Use mil.lib;.
DLL	Requires mil.dll, mil3d.dll for 3D compensation.