MdigGrabWait

See also

User Guide:

Grabbing and processing

Reference:

MdigControl MdigGrabContinuous

Availability

Available in MIL-Lite

Available in MIL

Available on Windows

Available on Linux

Not supported on:

Not supported on Matrox Indio (Update 53 or Update 68) (w)

Not supported on Matrox Concord PoE with ToE (Update 82) (z)

Partially supported on:

Partially supported on Host system (a)

Fully supported on:

Fully supported on Matrox GigE Vision driver (MIL 10, Update 25, Update 54, or Update 85)* (c)

Fully supported on Matrox Morphis (g)

Fully supported on Matrox Morphis QxT (h)

Fully supported on Matrox Orion HD (i)

Fully supported on Matrox Radient eCL (j)

Fully supported on Matrox Radient eV-CXP (MIL 10 or Update 29)* (k)

Fully supported on Matrox Solios eA/XA (l)

Fully supported on Matrox Solios ecl/xcl/ev-cl (m)

Fully supported on Matrox USB3 Vision driver (Update 19) (o)

Fully supported on Matrox RadientPro-CL (Update 7) (p)

Fully supported on Matrox Radient eV-CL (Update 27 or 74) (r)

Fully supported on Matrox Iris GTR (Update 28 or Update 68) (t)

Fully supported on Matrox Clarity UHD (Update 36 or 76) (u)

Fully supported on Matrox GenTL driver (Update 34) (v)

Fully supported on Matrox Rapixo CXP (Update 75 or Update 84) (y)

Fully supported on Matrox Rapixo CL Pro (Update 96) (aa)

* Refer to the MIL system-specific information
in the MIL Reference for the minimum update required.

For any information regarding a MIL system added during a MIL Update, see the MIL system’s release note

Available on Non-Matrox computer

Available on Matrox 4Sight-X

Available on Matrox 4Sight GP/GPm

Available on Matrox Supersight

Function map

Examples

mdigdoublebuffering.cpp
mdigdoublebuffering.cs
mdigdoublebuffering.vb
mgraweb.cpp
mmodeltracking.cpp
mmodeltracking.cs
mmodeltracking.vb
morphischannelswitchingdlg.cpp

Function Map

- DigId

- ControlFlag

Table:

For specifying the function's control flag

Compilation information

Synopsis

Wait for the end of the grab in progress.

Syntax

void MdigGrabWait(

MIL_ID DigId,	//in
MIL_INT64 ControlFlag	//in

)

Description

This function allows you to temporarily override the grab mode on the specified digitizer (see MdigControl() with M_GRAB_MODE).

Using this function forces the grab to wait until the grab timeout value has expired (set using MdigControl() with M_GRAB_TIMEOUT). Note that if the grab timeout is set to infinite, the grab will never end and this function will wait indefinitely. If the grabbed frame is not returned within the period of the timeout, an error is generated.

[Host system]

When grabbing from a video or directory of images, once the last image is grabbed, grabbing will restart from the beginning of the video or from the first image in the directory.

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 which MIL system’s documentation you should use in its place and any possible differences.

Parameters

This function is not supported on the selected boards.

This function reference has not been updated for the selected MIL system. To show the content of this page, choose a second MIL system; refer to the MIL system's release note to see which MIL system’s documentation to choose and any possible differences.

Parameters

DigId

Specifies the identifier of the digitizer.

ControlFlag

Specifies the function's control flag. This parameter must be set to one of the following:

For specifying the function's control flag
Value	Description
M_GRAB_END	Wait for the end of all queued grabs. This value should not be used when grabbing data with MdigGrabContinuous(). (summarize) Wait for the end of all queued grabs. (more details...)
M_GRAB_FRAME_END	Waits for the end of the current grab.

Compilation information

Header	Include mil.h.
Library	Use mil.lib.
DLL	Requires mil.dll.