Click here to show toolbars of the Web Online Help System: show toolbars |
Table: | For thread contexts |
Table: | For MIL events |
Table: | For mutexes |
MIL_ID ThreadEventOrMutexId, | //in |
MIL_INT64 InquireType, | //in |
void *UserVarPtr | //out |
Specifies the identifier of a user-allocated MIL thread context, event, or mutex, allocated using MthrAlloc(). This parameter should be set to one of the following values:
For a user-allocated thread context or
event
|
|||||||||||||||||||||||||||||||||||||||
Value | Description | ||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default MIL thread context identifier associated with the current Host thread. |
||||||||||||||||||||||||||||||||||||||
MIL event identifier |
Specifies the identifier of a user-allocated MIL event (MthrAlloc()). |
||||||||||||||||||||||||||||||||||||||
MIL mutex identifier |
Specifies the identifier of a user-allocated MIL mutex (MthrAlloc()). |
||||||||||||||||||||||||||||||||||||||
MIL system identifier |
Specifies the identifier of a valid system identifier (MsysAlloc()). |
||||||||||||||||||||||||||||||||||||||
MIL thread context identifier |
Specifies the identifier of a user-allocated MIL thread context (MthrAlloc()). |
Specifies the type of information about which to inquire. This parameter can be set to one of the values below. See MthrControl() for more information about these values.
See the Parameter associations section for possible values that can be specified.
Specifies the address in which to write the requested information. Since the MthrInquire() function also returns the requested information, you can set this parameter to M_NULL.
See the Parameter associations section for possible values that can be returned.
The tables below list possible values for the InquireType parameter and possible values returned to the UserVarPtr parameter.
The following InquireType settings can be specified to inquire about MIL thread contexts.
For thread contexts
|
|||||||||||||||||||||||||||||||||||||||
InquireType | Description | MIL system-specific tooltip (‡) |
|||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_ACCELERATOR |
Inquires whether the thread uses hardware acceleration. SET |
‡ | a | c M10 |
g | h | i | j | k M10 |
l | m | o | p | r U27 |
t U28 |
u U36 |
v | w U53 |
y U75 |
z | aa | ||||||||||||||||||
UserVarPtr extra info |
Data type info: Data
type: address of a MIL_INT
|
‡ | a | c M10 |
g | h | i | j | k M10 |
l | m | o | p | r U27 |
t U28 |
u U36 |
v | w U53 |
y U75 |
z | aa | ||||||||||||||||||
M_DISABLE |
Specifies not to use hardware acceleration. |
‡ | a | c M10 |
g | h | i | j | k M10 |
l | m | o | p | r U27 |
t U28 |
u U36 |
v | w U53 |
y U75 |
z | aa | ||||||||||||||||||
M_ENABLE |
Specifies to use hardware acceleration. |
‡ | a | c M10 |
g | h | i | j | k M10 |
l | m | o | p | r U27 |
t U28 |
u U36 |
v | w U53 |
y U75 |
z | aa | ||||||||||||||||||
M_BUS_MASTER_COPY_MODE |
Inquires the synchronization mode for copy operations when they are driven by your imaging board (bus master). SET |
‡ | g | h | j | k M10 |
l | m | p | r U27 |
y U75 |
aa | |||||||||||||||||||||||||||
UserVarPtr extra info |
Data type info: Data
type: address of a MIL_INT
|
‡ | g | h | j | k M10 |
l | m | p | r U27 |
y U75 |
aa | |||||||||||||||||||||||||||
M_ASYNCHRONOUS |
Specifies that when possible, control will be returned to the imaging board (bus master) immediately after a copy operation is launched. |
‡ | g | h | j | k M10 |
l | m | p | r U27 |
y U75 |
aa | |||||||||||||||||||||||||||
M_SYNCHRONOUS |
Specifies that the execution of a copy operation must be completed before returning control to the imaging board (bus master). |
‡ | g | h | j | k M10 |
l | m | p | r U27 |
y U75 |
aa | |||||||||||||||||||||||||||
M_THREAD_MODE |
Inquires the thread's execution mode. SET |
‡ | a | c M10 |
g | h | i | j | k M10 |
l | m | o | p | r U27 |
t U28 |
u U36 |
v | w U53 |
y U75 |
z | aa | ||||||||||||||||||
UserVarPtr extra info |
Data type info: Data
type: address of a MIL_INT
|
‡ | a | c M10 |
g | h | i | j | k M10 |
l | m | o | p | r U27 |
t U28 |
u U36 |
v | w U53 |
y U75 |
z | aa | ||||||||||||||||||
M_ASYNCHRONOUS |
Specifies that the thread will execute in asynchronous mode, if possible. INFO |
‡ | a | c M10 |
g | h | i | j | k M10 |
l | m | o | p | r U27 |
t U28 |
u U36 |
v | w U53 |
y U75 |
z | aa | ||||||||||||||||||
M_SYNCHRONOUS |
Specifies that the thread will execute in synchronous mode. INFO |
‡ | a | c M10 |
g | h | i | j | k M10 |
l | m | o | p | r U27 |
t U28 |
u U36 |
v | w U53 |
y U75 |
z | aa | ||||||||||||||||||
M_THREAD_PRIORITY |
Inquires the priority setting of the thread. SET |
‡ | a | c M10 |
g | h | i | j | k M10 |
l | m | o | p | r U27 |
t U28 |
u U36 |
v | w U53 |
y U75 |
z | aa | ||||||||||||||||||
UserVarPtr extra info |
Data type info: Data
type: address of a MIL_INT
|
‡ | a | c M10 |
g | h | i | j | k M10 |
l | m | o | p | r U27 |
t U28 |
u U36 |
v | w U53 |
y U75 |
z | aa | ||||||||||||||||||
M_ABOVE_NORMAL |
Specifies that the thread is above normal priority. INFO |
‡ | a | c M10 |
g | h | i | j | k M10 |
l | m | o | p | r U27 |
t U28 |
u U36 |
v | w U53 |
y U75 |
z | aa | ||||||||||||||||||
M_BELOW_NORMAL |
Specifies that the thread is below normal priority. INFO |
‡ | a | c M10 |
g | h | i | j | k M10 |
l | m | o | p | r U27 |
t U28 |
u U36 |
v | w U53 |
y U75 |
z | aa | ||||||||||||||||||
M_IDLE |
Specifies that the thread is idle. INFO |
‡ | a | c M10 |
g | h | i | j | k M10 |
l | m | o | p | r U27 |
t U28 |
u U36 |
v | w U53 |
y U75 |
z | aa | ||||||||||||||||||
M_LOWEST |
Specifies that the thread is of the lowest priority. INFO |
‡ | a | c M10 |
g | h | i | j | k M10 |
l | m | o | p | r U27 |
t U28 |
u U36 |
v | w U53 |
y U75 |
z | aa | ||||||||||||||||||
M_NORMAL |
Specifies that the thread is of normal priority. INFO |
‡ | a | c M10 |
g | h | i | j | k M10 |
l | m | o | p | r U27 |
t U28 |
u U36 |
v | w U53 |
y U75 |
z | aa | ||||||||||||||||||
M_TIME_CRITICAL |
Specifies that the thread is time critical. INFO |
‡ | a | c M10 |
g | h | i | j | k M10 |
l | m | o | p | r U27 |
t U28 |
u U36 |
v | w U53 |
y U75 |
z | aa |
The following InquireType settings can be specified to inquire about MIL events.
For MIL events
|
|||||||||||||||||||||||||||||||||||||||
InquireType | Description | ||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_EVENT_MODE |
Inquires the reset mode of the event. SET |
||||||||||||||||||||||||||||||||||||||
UserVarPtr extra info |
Data type info: Data
type: address of a MIL_INT
|
||||||||||||||||||||||||||||||||||||||
M_AUTO_RESET |
Specifies that the event is reset automatically. INFO |
||||||||||||||||||||||||||||||||||||||
M_MANUAL_RESET |
Specifies that the event is reset manually. INFO |
||||||||||||||||||||||||||||||||||||||
M_EVENT_STATE |
Inquires the state of the event. SET |
||||||||||||||||||||||||||||||||||||||
UserVarPtr extra info |
Data type info: Data
type: address of a MIL_INT
|
||||||||||||||||||||||||||||||||||||||
M_NOT_SIGNALED |
Specifies the not-signaled state. |
||||||||||||||||||||||||||||||||||||||
M_SIGNALED |
Specifies the signaled state. |
The following InquireType settings can be specified to inquire about MIL mutexes.
For mutexes
|
|||||||||||||||||||||||||||||||||||||||
InquireType | Description | ||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_LOCK_TRY |
Inquires whether the specified MIL mutex is locked by the current thread. |
||||||||||||||||||||||||||||||||||||||
UserVarPtr extra info |
Data type info: Data
type: address of a MIL_INT
|
||||||||||||||||||||||||||||||||||||||
M_NO |
Specifies that the current thread has not locked the specified mutex. |
||||||||||||||||||||||||||||||||||||||
M_YES |
Specifies that the current thread has locked the specified mutex. |
Header | Include mil.h. |
Library | Use mil.lib. |
DLL | Requires mil.dll. |