MsysInquire()函数

Synopsis

Inquire about a system.

Format

long MsysInquire(SystemId, ParamToInquire, UserVarPtr)

MIL_ID SystemId; System identifier
long InquireType; Type of information to inquire
void *UserVarPtr; Storage location for inquired information

Description

This function inquires about the specified system parameter setting.

The SystemId parameter specifies the system identifier.

The InquireType parameter specifies the system parameter about which to inquire. Some of the values are not supported by all platforms. This parameter can be set to one of the following values:

InquireType Description
M_OWNER_APPLICATION The MIL identifier (MIL_ID) of the application on which the system has been allocated.
M_SYSTEM_TYPE The type of system allocated. Either M_SYSTEM_HOST_TYPE, M_SYSTEM_VGA_TYPE, M_SYSTEM_METEOR_TYPE
M_SYSTEM_TYPE_PTR Pointer to a function that can communicate with the system (board). This inquiry type returns the actual system type pointer that was passed to the MsysAlloc?function upon system allocation. It is preferable to use M_SYS_TYPE to inquire about the type of system allocated.
M_NUMBER Board number of the system (MsysAlloc).
M_INIT_FLAG System initialization flag (MsysAlloc).
M_DISPLAY_NUM Number of displays available on the system.
M_DIGITIZER_NUM Number of digitizers available on the system.
M_PROCESSOR_NUM Number of processors available on the system.
M_PROCESSING_SYSTEM_TYPE Processing system type used to process buffers allocated on that system (MsysContro). Either M_SYSTEM_HOST_TYPE, M_SYSTEM_VGA_TYPE, M_SYSTEM_METEOR_TYPE, M_SYSTEM_PULSAR_TYPE or M_SYSTEM_GENESIS_TYPE will be returned.
M_PROCESSING_SYSTEM Identifier of the processing system.
M_DCF_SUPPORTED Whether the system supports downloadable digitizer configuration format (.dcf) files.
M_USE_MMX State of use of MMX code for processing on the specified system (M_ENABLE or M_DISABLE).

The UserVarPtr parameter specifies the address of the variable in which the requested information is to be written. Since the MsysInquire function also returns the requested information, you can set this parameter to M_NULL.

The variable should be a pointer to a long except for ParamToInquire types: M_OWNER_APPLICATION and M_PROCESSING_SYSTEM_TYPE, which should be a pointer to a MIL_ID, and M_SYSTEM_TYPE_PTR, which should be a void pointer.

Returned value

The returned value is the requested system information, cast to long.

See also

MsysAlloc, MsysControl

《MsysInquire()函数》上有28条评论

评论已关闭。