MdigGetHookInfo

• Filters
• See also
User Guide:
DirectShow capture filter for MIL Event handling in MIL with hook-handler functions Using input signals Using quadrature input from a rotary encoder
Reference:
MbufInquire MdigAlloc MdigControl MdigControlFeature MdigHookFunction MdigInquire MdigProcess MsysInquire
Availability
Available in MIL-Lite
Available in MIL


Available on Windows
Available on Linux


Not supported on:
Not supported on Matrox GPU processing driver (d)
Partially supported on:
Partially supported on Host system (a)
Partially supported on Matrox CronosPlus (b)
Partially supported on Matrox GigE Vision driver (c)
Partially supported on Matrox IEEE 1394 IIDC driver (e)
Partially supported on Matrox Iris GT (f)
Partially supported on Matrox Morphis (g)
Partially supported on Matrox Morphis QxT (h)
Partially supported on Matrox Orion HD (i)
Partially supported on Matrox Radient eCL (j)
Partially supported on Matrox Radient eV-CXP (k)
Partially supported on Matrox Solios eA/XA (l)
Partially supported on Matrox Solios ecl/xcl/ev-cl (m)
Partially supported on Matrox Vio (n)
Partially supported on Matrox USB3 Vision driver (requires Update 19) (o)
Partially supported on Matrox RadientPro-CL (requires Update 7) (p)
Partially supported on Matrox Radient eV-CLHS (requires Update 21) (q)
Partially supported on Matrox Radient eV-CL (requires Update 27) (r)
Partially supported on Matrox GigE Vision driver (requires Update 25) (s)
Partially supported on Matrox Iris GTR (requires Update 28) (t)


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
baslertofexample.cpp
blobmerge.cpp
cameraevents.cpp
chunkmode.cpp
depthfromfocus.cpp
dmilmdigprocesssharedmemory.cpp
dmilmultisystem.cpp
dmilobjecttrackingslave.cpp
extendeddepthoffield.cpp
fdklutmapmain.cpp
fdkoffsetgainlutmapmain.cpp
fdkoffsetgainmain.cpp
fdkoffsetgainminmaxmain.cpp
fixturingusingblob.cpp
flatfieldcorrection.cpp
mapptrace.cpp
mapptrace.cs
mapptrace.vb
matroxgatoreye.cpp
mdigcrossbar.cpp
mdiggrabsequence.cpp
mdiggrabsequence.cs
mdiggrabsequence.vb
mdigprocess.cpp
mdigprocess.cs
mdigprocess.vb
mdigprocess16vd.cpp
mdigprocessmultiple.cpp
milcapture.cpp
milgige.cpp
mseqprocess.cpp
mseqprocess.cs
mseqprocess.vb
multicamera.cpp
multicastmaster.cpp
multicastmonitor.cpp
multicastslave.cpp
packetdelay.cpp
pfocus.cpp
processingfpga.cpp
scriptpreprocessing.cpp
sickrangerc.cpp
viofeaturesdemo.cpp

MdigFree
MdigGrab

Description

Parameters

EventId

Specifies the digitizer event identifier received by the hook-handler function (see MdigProcess() and MdigHookFunction()).

InfoType

Specifies the type of information about the event to return.

See the Parameter associations section for possible values that can be specified.

UserVarPtr

Accepts the address of one of the following (see the Parameter associations section for specifics on which is expected):

• array of type MIL_INT64
• array of type MIL_TEXT_CHAR
• MIL_DOUBLE
• MIL_ID
• MIL_INT
• MIL_INT64

Specifies the address in which to write the requested information.

See the Parameter associations section for possible values that can be returned.

Parameter associations

The tables below list possible values for the InfoType parameter and possible values returned to the UserVarPtr parameter.

• For retrieving information about a general digitizer hook event
• For retrieving information about a GenICam SFNC-compliant event
• For retrieving information about a grab event
• For retrieving information about an I/O event
• For retrieving information about a reference latch value
• For retrieving information about a rotary decoder event
• For retrieving information from a data latch
• For retrieving information from a GenICam feature change event

The following allows you to retrieve information about various digitizer hook event. Unless otherwise specified, you can retrieve these information types if you call this function from within a function hooked to any digitizer event using MdigHookFunction() or MdigProcess().

For retrieving information about a general digitizer hook event
InfoType		Description		MIL system-specific tooltip (‡)
	UserVarPtr - Possible values returned
M_DIGITIZER_ID		Retrieves the MIL identifier of the digitizer that was used by MdigProcess(). Note that this information is only available for digitizer events generated by MdigProcess(). (summarize) Retrieves the MIL identifier of the digitizer that was used by MdigProcess(). (more details...)																								‡	a	b	c		e	f	g	h	i	j	k	l	m	n	o	p	q	r	s	t	u
	UserVarPtr extra info	Data type info: Data type: address of a MIL_ID Data type info: Data type: address of a MIL_ID		‡	a	b	c		e	f	g	h	i	j	k	l	m	n	o	p	q	r	s	t	u
	MIL digitizer identifier	Specifies the MIL identifier of the digitizer.		‡	a	b	c		e	f	g	h	i	j	k	l	m	n	o	p	q	r	s	t	u
M_GC_CAMERA_TIME_STAMP		Retrieves the time at which the event occurred. This value was generated by the camera, using a specialized counter. To inquire the time stamp generated by the operating system, use M_TIME_STAMP. (summarize) Retrieves the time at which the event occurred. (more details...)		‡			c												o				s
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE		‡			c												o				s
	Value	Specifies the camera's time stamp, in secs.		‡			c												o				s
M_GC_EVENT_TYPE		Retrieves the GigE Vision event type, as sent by the camera. Refer to your GenICam SFNC specification, or your camera's documentation for a list of GigE Vision event types. (summarize) Retrieves the GigE Vision event type, as sent by the camera. (more details...)		‡			c												o				s
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT		‡			c												o				s
	Value	Specifies the GigE Vision event type.		‡			c												o				s
M_GC_PACKET_SIZE		Retrieves the size of the data packet, used by the GenICam SFNC-compliant camera when streaming data to the Host. (summarize) Retrieves the size of the data packet, used by the GenICam SFNC-compliant camera when streaming data to the Host. (more details...)		‡			c																s
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT		‡			c																s
	Value	Specifies the size of the packet, in bytes.		‡			c																s
M_TIME_STAMP		Retrieves the operating system's time stamp at the point which the event generated a service request. The time stamp is generated by the operating system's performance counter. Time stamps can be used to see if a frame has been missed since the last time stamp. (summarize) Retrieves the operating system's time stamp at the point which the event generated a service request. (more details...)		‡	a	b	c		e	f	g	h	i	j	k	l	m	n	o	p	q	r	s	t	u
			MIL system specific
			This value is generated by the operating system. To use the time stamp generated by the camera, use M_GC_CAMERA_TIME_STAMP.	‡			c												o				s
	UserVarPtr extra info	Data type info: Data type: address of a MIL_DOUBLE Data type info: Data type: address of a MIL_DOUBLE		‡	a	b	c		e	f	g	h	i	j	k	l	m	n	o	p	q	r	s	t	u
	Value	Specifies operating system's time stamp, in secs.		‡	a	b	c		e	f	g	h	i	j	k	l	m	n	o	p	q	r	s	t	u

The following allows you to retrieve information about a GenICam SFNC-compliant event. The following information types are only available if MdigGetHookInfo() was called from a function hooked to a GenICam event using M_GC_EVENT. In addition, the GenICam event must be enabled using MdigControlFeature(), and the message channel must be supported by your camera.

For retrieving information about a GenICam SFNC-compliant event
InfoType		Description	MIL system-specific tooltip (‡)
	UserVarPtr - Possible values returned
M_COUNTER_INDEX		Retrieves the index of a counter on your camera. You can retrieve this value if the hook-handler function was hooked using MdigHookFunction() with M_GC_EVENT + M_COUNTER_START + n or M_GC_EVENT + M_COUNTER_END + n, where n is the counter's index. Counters are unique to GenICam SFNC-compliant cameras. To configure your GenICam SFNC-compliant counters, use MdigControlFeature(). (summarize) Retrieves the index of a counter on your camera. (more details...)																							‡			c												o				s
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT	‡			c												o				s
	Value	Specifies the index of the counter.	‡			c												o				s
M_LINE_INDEX		Retrieves the index of the I/O signal that generated the GenICam SFNC-compatible camera's event. You can only retrieve this information if the hook-handler function was hooked using MdigHookFunction() with M_GC_EVENT + M_LINE_ANY_EDGE + n, M_GC_EVENT + M_LINE_FALLING_EDGE + n, or M_GC_EVENT + M_LINE_RISING_EDGE + n, where n is the I/O signal's number. (summarize) Retrieves the index of the I/O signal that generated the GenICam SFNC-compatible camera's event. (more details...)	‡			c												o				s
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT	‡			c												o				s
	Value	Specifies the number of the I/O signal that generated the event.	‡			c												o				s
M_TIMER_INDEX		Retrieves the index of the timer that generated the generic the GenICam SFNC-compatible camera's event. You can retrieve this value if the hook-handler function was hooked using MdigHookFunction() with M_GC_EVENT + M_TIMER_START + n or M_GC_EVENT + M_TIMER_END + M_TIMERn, where n is the timer index. (summarize) Retrieves the index of the timer that generated the generic the GenICam SFNC-compatible camera's event. (more details...)	‡			c												o				s
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT	‡			c												o				s
	Value	Specifies the index of the timer that generated the event.	‡			c												o				s

The following allows you to retrieve information about a grab event.

Unless otherwise specified, the following information types are only available if MdigGetHookInfo() was called from a function hooked to an event using MdigHookFunction() or MdigProcess() with M_GRAB_..._END. If inquired from any other hook function, these information types will not return an error, but the result will be irrelevant.

For retrieving information about a grab event
InfoType		Description		MIL system-specific tooltip (‡)
	UserVarPtr - Possible values returned
M_CORRUPTED_FRAME		Retrieves whether the currently grabbed frame is corrupt. (summarize) Retrieves whether the currently grabbed frame is corrupt. (more details...)																								‡			c						i						o				s		u
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT		‡			c						i						o				s		u
	M_NO	Specifies that the frame is not corrupt.		‡			c						i						o				s		u
	M_YES	Specifies that the frame is corrupt.		‡			c						i						o				s		u
M_GC_FRAME_BLOCK_ID		Retrieves the value of the counter used by the camera to identify each frame grabbed. In this case, the value of the counter for the last frame grabbed is returned. (summarize) Retrieves the value of the counter used by the camera to identify each frame grabbed. (more details...)		‡			c												o				s
			MIL system specific
			Note that a GigE Vision 2.0 camera has a 64-bit frame counter, while a GigE Vision 1.0 camera has a 16-bit frame counter.	‡																			s
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT		‡			c												o				s
	Value	Specifies the value of the counter.		‡			c												o				s
M_GC_FRAME_ERROR_CODE		Retrieves the error code returned by the camera for the last frame grabbed. (summarize) Retrieves the error code returned by the camera for the last frame grabbed. (more details...)		‡			c												o				s
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT		‡			c												o				s
	Value	Specifies the GigE Vision error code.		‡			c												o				s
M_GC_FRAME_LINE_COUNT		Retrieves the number of rows in the last frame grabbed. (summarize) Retrieves the number of rows in the last frame grabbed. (more details...)		‡			c												o				s
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT		‡			c												o				s
	Value	Specifies the row count.		‡			c												o				s
M_GC_FRAME_PIXEL_TYPE		Retrieves the data depth and raw color format of the last frame grabbed. Note that this value is a value, specified by GenICam's standard feature naming convention (SFNC). The predefined list of possible pixel formats are in the PFNC.h header file in the MIL installation folder, under the include\MilDyn subfolder. (summarize) Retrieves the data depth and raw color format of the last frame grabbed. (more details...)		‡			c												o				s
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT		‡			c												o				s
	Value	Specifies the data depth and raw color format of the last frame grabbed.		‡			c												o				s
M_GC_FRAME_SIZE_X		Retrieves the width (size X) of the last frame grabbed. (summarize) Retrieves the width (size X) of the last frame grabbed. (more details...)		‡			c												o				s
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT		‡			c												o				s
	Value	Specifies the width of the last frame grabbed.		‡			c												o				s
M_GC_FRAME_SIZE_Y		Retrieves the height (size Y) of the last frame grabbed. (summarize) Retrieves the height (size Y) of the last frame grabbed. (more details...)		‡			c												o				s
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT		‡			c												o				s
	Value	Specifies the height of the last frame grabbed, in pixels.		‡			c												o				s
M_GC_FRAME_STATUS_CODE		Retrieves the status code from the last frame grabbed. The predefined list of frame status codes are in the GVCP_Status_Codes.h header file in the MIL installation folder, under the include\MilDyn subfolder. (summarize) Retrieves the status code from the last frame grabbed. (more details...)		‡			c												o				s
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT		‡			c												o				s
	Value	Specifies the status code.		‡			c												o				s
M_GC_PACKETS_MISSED		Retrieves the number of missing packets in the corrupted frame. If 0 is returned, the frame is not corrupted. (summarize) Retrieves the number of missing packets in the corrupted frame. (more details...)		‡			c																s
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT		‡			c																s
	Value	Specifies the number of missing packets.		‡			c																s
M_GC_PACKETS_RECEIVED		Retrieves the number of packets in the frame. (summarize) Retrieves the number of packets in the frame. (more details...)		‡			c																s
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT		‡			c																s
	Value	Specifies the number of packets in the frame.		‡			c																s
M_GC_PACKETS_RECOVERED		Retrieves the number of packets successfully recovered in the frame. (summarize) Retrieves the number of packets successfully recovered in the frame. (more details...)		‡			c																s
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT		‡			c																s
	Value	Specifies the number of recovered packets.		‡			c																s
M_GC_PACKETS_RESENDS_NUM		Retrieves the number of resend commands sent to the camera for a frame. Note that one resend command can contain multiple consecutive packets. (summarize) Retrieves the number of resend commands sent to the camera for a frame. (more details...)		‡			c																s
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT		‡			c																s
	Value	Specifies the number of resend commands sent.		‡			c																s
M_GRAB_LINE		Retrieves the number of the line (row) that, upon it being received by the digitizer, generated the event. You can only retrieve this information if the hook-handler function was hooked using MdigHookFunction() with M_GRAB_LINE + n, where n is the row number. Note that upon this event, the row has not necessarily been written to the grab buffer. (summarize) Retrieves the number of the line (row) that, upon it being received by the digitizer, generated the event. (more details...)		‡		b			e	f	g	h	i		k	l	m	n						t	u
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT		‡		b			e	f	g	h	i		k	l	m	n						t	u
	Value	Specifies the row number.		‡		b			e	f	g	h	i		k	l	m	n						t	u
M_GRAB_LINE_COUNT		Retrieves the number of lines (rows) grabbed. Note that the data contained in the line is available for processing. This is useful when grabbing from a line-scan camera with frames of variable length. (summarize) Retrieves the number of lines (rows) grabbed. (more details...)		‡			c								k	l	m		o	p	q	r	s
			MIL system specific
			You can only retrieve this value if the hook-handler function was hooked using MdigProcess() or MdigHookFunction() with M_GRAB_END or M_GRAB_FRAME_END.	‡			c												o				s
			You can only retrieve this value if the row count was enabled using MdigControl() with M_GRAB_LINE_COUNTER and the hook-handler function was hooked using MdigProcess() or MdigHookFunction() with M_GRAB_END or M_GRAB_FRAME_END.	‡											k	l	m			p	q	r
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT		‡			c								k	l	m		o	p	q	r	s
	Value	Specifies the row number.		‡			c								k	l	m		o	p	q	r	s
M_GRAB_LINE_END		Retrieves the number of the line (row) that, upon it being available in the grab buffer, generated the event. You can only retrieve this information if the hook-handler function was hooked using MdigHookFunction() with M_GRAB_LINE_END + n, where n is the row number. Note that upon this event, the row is available in the grab buffer. (summarize) Retrieves the number of the line (row) that, upon it being available in the grab buffer, generated the event. (more details...)		‡												l	m
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT		‡												l	m
	Value	Specifies the row number.		‡												l	m
M_MODIFIED_BUFFER +		Retrieves information about a modified-buffer type of event. (summarize) Retrieves information about a modified-buffer type of event. (more details...)		‡	a	b	c		e	f	g	h	i	j	k	l	m	n	o	p	q	r	s	t	u
			MIL system specific
			You can only retrieve this information if the hook-handler function was hooked using MdigProcess() or MdigHookFunction() with M_GRAB....	‡		b			e
	UserVarPtr extra info	Data type info: Data type: address of a MIL_ID Data type info: Data type: address of a MIL_ID		‡	a	b	c		e	f	g	h	i	j	k	l	m	n	o	p	q	r	s	t	u
	Value	Specifies information about a modified-buffer event.		‡	a	b	c		e	f	g	h	i	j	k	l	m	n	o	p	q	r	s	t	u
M_TIMER_TRIGGER_MISSED +		Retrieves the number of triggers missed by the specified timer. You can only retrieve this value if MdigGetHookInfo() was called from a function hooked to an end of grab event using MdigHookFunction() with M_GRAB_END or if the hook-handler function was hooked using MdigProcess(). You must specify a combination value from the following table: To set the timer to inquire (summarize) Retrieves the number of triggers missed by the specified timer. (more details...)		‡										j	k	l	m			p	q	r
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT		‡										j	k	l	m			p	q	r
	Value	Specifies the number of missed triggers.		‡										j	k	l	m			p	q	r

Combination value for M_TIMER_TRIGGER_MISSED.

You must add the following value to the above-mentioned value to set the timer to inquire.

For specifying the timer to inquire
Combination value	Description	MIL system-specific tooltip (‡)
M_TIMERn	Specifies the timer, where n can be from 1 to 4.	‡										j	k	l	m			p	q	r

Combination values for M_MODIFIED_BUFFER.

You can add one of the following values to the above-mentioned value to specify the type of information to return about the modified image buffer.

For retrieving information about the modified image buffer
InfoType		Description	MIL system-specific tooltip (‡)
	UserVarPtr - Possible values returned
M_BUFFER_ID		Retrieves the MIL identifier of the modified image buffer. (summarize) Retrieves the MIL identifier of the modified image buffer. (more details...)																							‡	a	b	c		e	f	g	h	i	j	k	l	m	n	o	p	q	r	s	t	u
	UserVarPtr extra info	Data type info: Data type: address of a MIL_ID Data type info: Data type: address of a MIL_ID	‡	a	b	c		e	f	g	h	i	j	k	l	m	n	o	p	q	r	s	t	u
	MIL buffer identifier	Specifies the MIL identifier of the modified image buffer associated with the event.	‡	a	b	c		e	f	g	h	i	j	k	l	m	n	o	p	q	r	s	t	u
M_BUFFER_INDEX		Retrieves the index of the modified image buffer in the image buffer array passed to MdigProcess(), if the hook-handler function was hooked using MdigProcess(). This index always starts at 0. (summarize) Retrieves the index of the modified image buffer in the image buffer array passed to MdigProcess(), if the hook-handler function was hooked using MdigProcess(). (more details...)	‡	a	b	c		e	f	g	h	i	j	k	l	m	n	o	p	q	r	s	t	u
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT	‡	a	b	c		e	f	g	h	i	j	k	l	m	n	o	p	q	r	s	t	u
	Value	Specifies the index of the modified image buffer.	‡	a	b	c		e	f	g	h	i	j	k	l	m	n	o	p	q	r	s	t	u
M_REGION_OFFSET_X		Retrieves the X-offset of the modified region (of the image buffer). (summarize) Retrieves the X-offset of the modified region (of the image buffer). (more details...)	‡	a	b	c		e	f	g	h	i	j	k	l	m	n	o	p	q	r	s	t	u
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT	‡	a	b	c		e	f	g	h	i	j	k	l	m	n	o	p	q	r	s	t	u
	Value	Specifies the X-offset of the modified region.	‡	a	b	c		e	f	g	h	i	j	k	l	m	n	o	p	q	r	s	t	u
M_REGION_OFFSET_Y		Retrieves the Y-offset of the modified region (of the image buffer). (summarize) Retrieves the Y-offset of the modified region (of the image buffer). (more details...)	‡	a	b	c		e	f	g	h	i	j	k	l	m	n	o	p	q	r	s	t	u
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT	‡	a	b	c		e	f	g	h	i	j	k	l	m	n	o	p	q	r	s	t	u
	Value	Specifies the Y-offset of the modified region.	‡	a	b	c		e	f	g	h	i	j	k	l	m	n	o	p	q	r	s	t	u
M_REGION_SIZE_X		Retrieves the width of the modified region (of the image buffer). (summarize) Retrieves the width of the modified region (of the image buffer). (more details...)	‡	a	b	c		e	f	g	h	i	j	k	l	m	n	o	p	q	r	s	t	u
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT	‡	a	b	c		e	f	g	h	i	j	k	l	m	n	o	p	q	r	s	t	u
	Value	Specifies the width of the modified region.	‡	a	b	c		e	f	g	h	i	j	k	l	m	n	o	p	q	r	s	t	u
M_REGION_SIZE_Y		Retrieves the height of the modified region (of the image buffer). (summarize) Retrieves the height of the modified region (of the image buffer). (more details...)	‡	a	b	c		e	f	g	h	i	j	k	l	m	n	o	p	q	r	s	t	u
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT	‡	a	b	c		e	f	g	h	i	j	k	l	m	n	o	p	q	r	s	t	u
	Value	Specifies the height of the modified region.	‡	a	b	c		e	f	g	h	i	j	k	l	m	n	o	p	q	r	s	t	u

The following allows you to retrieve information about an I/O event. These information types are only available if MdigGetHookInfo() was called from a function hooked to event using MdigHookFunction() with M_IO_CHANGE.

For retrieving information about an I/O event
InfoType		Description	MIL system-specific tooltip (‡)
	UserVarPtr - Possible values returned
M_IO_INTERRUPT_SOURCE		Retrieves the auxiliary input signal that generated the interrupt. (summarize) Retrieves the auxiliary input signal that generated the interrupt. (more details...)																							‡			c							j	k	l	m		o	p	q	r	s
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT	‡			c							j	k	l	m		o	p	q	r	s
	M_AUX_IOn	Specifies the auxiliary input signal that generated the interrupt, where n is the signal number.	‡			c							j	k	l	m		o	p	q	r	s
M_IO_STATUS		Retrieves the state of the input signal that generated the interrupt. The returned value reflects the state of the input signal at the time of the interrupt. (summarize) Retrieves the state of the input signal that generated the interrupt. (more details...)	‡			c							j	k	l	m		o	p	q	r	s
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT	‡			c							j	k	l	m		o	p	q	r	s
	M_OFF	Specifies that the auxiliary input signal that generated the interrupt is off.	‡			c							j	k	l	m		o	p	q	r	s
	M_ON	Specifies that the auxiliary input signal that generated the interrupt is on.	‡			c							j	k	l	m		o	p	q	r	s

The following allows you to retrieve information about a reference latch event. The following information types are only available if using a latch that has previously saved the time or counter value upon a hardware event and using MdigHookFunction() with any hook event.

For retrieving information about a reference latch value
InfoType		Description	MIL system-specific tooltip (‡)
	UserVarPtr - Possible values returned
M_REFERENCE_LATCH_VALUE +		Retrieves the last timestamp or counter value stored by the specified latch. You must specify a combination value from the following table: To specify which of the I/O command lists to use (summarize) Retrieves the last timestamp or counter value stored by the specified latch. (more details...)																							‡																				t
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT64 Data type info: Data type: address of a MIL_INT64	‡																				t
	Value	Specifies the last timestamp or counter value stored by the specified latch.	‡																				t

Combination value for M_REFERENCE_LATCH_VALUE.

You must add the following value to the above-mentioned value to specify which of the I/O command lists to use.

For specifying the I/O command list to use
Combination value	Description	MIL system-specific tooltip (‡)
M_IO_COMMAND_LIST1	Specifies to inquire about I/O command list1.	‡																				t

The following allows you to retrieve information about a rotary decoder event. This information type is only available if MdigGetHookInfo() was called from a function hooked to event using MdigHookFunction() with M_ROTARY_ENCODER. In addition, you must have enabled the rotary decoder to store this information (before the grab), using MdigControl() with M_ROTARY_ENCODER_FRAME_END_READ. Note that the current value of the rotary decoder's counter can be inquired using MdigInquire() with M_ROTARY_ENCODER_POSITION.

For retrieving information about a rotary decoder event
InfoType		Description	MIL system-specific tooltip (‡)
	UserVarPtr - Possible values returned
M_ROTARY_ENCODER_FRAME_END_POSITION +		Retrieves the value of the rotary decoder's counter at the end of the last frame grabbed before the counter reached its trigger position. (summarize) Retrieves the value of the rotary decoder's counter at the end of the last frame grabbed before the counter reached its trigger position. (more details...)																							‡										j	k		m			p	q	r
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT	‡										j	k		m			p	q	r
	Value	Specifies the value of the rotary decoder's counter when the last frame was grabbed.	‡										j	k		m			p	q	r

Combination value for M_ROTARY_ENCODER_FRAME_END_POSITION.

You can add the following value to the above-mentioned value to specify which rotary decoder to inquire.

For specifying which rotary decoder to inquire
Combination value	Description	MIL system-specific tooltip (‡)
M_ROTARY_ENCODERn	Specifies to inquire rotary decoder n, where n is a number between 1 and 4. Note that if you do not use this combination constant to specify a rotary decoder, the rotary decoder corresponding to 1+ the device number of the specified digitizer (using MdigHookFunction() with DigId) will be used. For example, when the device number of the specified digitizer is M_DEV2, rotary decoder M_ROTARY_ENCODER3 is used. (summarize) Specifies to inquire rotary decoder n, where n is a number between 1 and 4. (more details...)	‡											k					p	q	r

The following allows you to retrieve information from a data latch. These information types are only available if MdigGetHookInfo() was called from a function hooked to an end of grabbed frame event using MdigHookFunction() with M_GRAB_FRAME_END or from the hook-handler function (callback function) of MdigProcess(). In addition, you must have enabled the data latch to store this information, using MdigControl() with M_DATA_LATCH_STATE.

Note that you can only use data latches in association with the MIL digitizer allocated using MdigAlloc() with M_DEV0.

For retrieving information from a data latch
InfoType		Description	MIL system-specific tooltip (‡)
	UserVarPtr - Possible values returned
M_DATA_LATCH_VALUE +		Retrieves the stored data of the specified data latch. If there are multiple instances of this data (for example, your data latch is triggered at the end of each grabbed line), use + M_VALUE_INDEX(). You must specify a combination value from the following table: To specify which data latch to inquire about (summarize) Retrieves the stored data of the specified data latch. (more details...)																							‡																p	q	r
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT64 Data type info: Data type: address of a MIL_INT64	‡																p	q	r
	M_NULL	Specifies that the stored data could not be read.	‡																p	q	r
	Value	Specifies the stored data.	‡																p	q	r
M_DATA_LATCH_VALUE_ALL +		Retrieves all the stored data of the specified data latch. You must specify a combination value from the following table: To specify which data latch to inquire about (summarize) Retrieves all the stored data of the specified data latch. (more details...)	‡																p	q	r
	UserVarPtr extra info	Data type info: Data type: array of type MIL_INT64 (more details...) Data type: array of type MIL_INT64 Required array size: MdigGetHookInfo() with M_DATA_LATCH_VALUE_COUNT Data type info: Data type: array of type MIL_INT64 (more details...) Data type: array of type MIL_INT64 Required array size: MdigGetHookInfo() with M_DATA_LATCH_VALUE_COUNT	‡																p	q	r
	Value	Specifies all the stored data.	‡																p	q	r
M_DATA_LATCH_VALUE_COUNT +		Counts the number of items stored inside a data latch. Note that a data latch is reset at every frame event. You must specify a combination value from the following table: To specify which data latch to inquire about (summarize) Counts the number of items stored inside a data latch. (more details...)	‡																p	q	r
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT64 Data type info: Data type: address of a MIL_INT64	‡																p	q	r
	Value	Specifies the number of instances. Note that a data latch is reset at every frame event. (summarize) Specifies the number of instances. (more details...)	‡																p	q	r

Combination value for the values listed in For retrieving information from a data latch.

You must add the following value to the above-mentioned values to specify which data latch to inquire about.

For specifying the data latch to inquire
Combination value	Description	MIL system-specific tooltip (‡)
M_LATCHn	Specifies the data latch from which to retrieve information, where n is a value from 0 to 15.	‡																p	q	r

Combination value for M_DATA_LATCH_VALUE.

You can add the following value to the above-mentioned value to specify the instance of the stored information to retrieve.

For identifying the instance of the stored information to retrieve
Combination value	Description		MIL system-specific tooltip (‡)
M_VALUE_INDEX( MIL_INT64 IndexValue )	Specifies the instance of stored information to retrieve. (summarize) Specifies the instance of stored information to retrieve. (more details...)		‡																p	q	r
		Parameters
		IndexValue Sets the instance of stored information. For example, to read the information latched when the last line finishes being grabbed for a frame, with 1024 lines, the instance would be 1023.	‡																p	q	r

The following allows you to retrieve information from a GenICam feature change event. These information types are only available if MdigGetHookInfo() was called from a function hooked to GenICam feature change event using MdigHookFunction() with M_FEATURE_CHANGE.

For retrieving information from a GenICam feature change event
InfoType		Description	MIL system-specific tooltip (‡)
	UserVarPtr - Possible values returned
M_GC_FEATURE_CHANGE_NAME		Retrieves the name of the GenICam feature that changed. (summarize) Retrieves the name of the GenICam feature that changed. (more details...)																							‡																			s
	UserVarPtr extra info	Data type info: Data type: array of type MIL_TEXT_CHAR (more details...) Data type: array of type MIL_TEXT_CHAR Required array size: MdigGetHookInfo() with M_GC_FEATURE_CHANGE_NAME_SIZE Data type info: Data type: array of type MIL_TEXT_CHAR (more details...) Data type: array of type MIL_TEXT_CHAR Required array size: MdigGetHookInfo() with M_GC_FEATURE_CHANGE_NAME_SIZE	‡																			s
	Value	Specifies the feature name.	‡																			s
M_GC_FEATURE_CHANGE_NAME_SIZE		Retrieves the string length of the feature name that changed. (summarize) Retrieves the string length of the feature name that changed. (more details...)	‡																			s
	UserVarPtr extra info	Data type info: Data type: address of a MIL_INT Data type info: Data type: address of a MIL_INT	‡																			s
	Value	Specifies the length of the string.	‡																			s

Return value

The returned value is M_NULL if successful. If the operation fails, a non-null (!M_NULL) value is returned.