MIL_ID SystemId, | //in |
MIL_INT SizeBand, | //in |
MIL_INT SizeX, | //in |
MIL_INT SizeY, | //in |
MIL_INT Type, | //in |
MIL_INT64 Attribute, | //in |
MIL_ID *BufIdPtr | //out |
This function allocates a data buffer with multiple color bands on the specified system. This type of buffer allows for the representation of color images (for example, RGB).
This function allocates buffers that have a two-dimensional surface for each specified color band. You can use MbufAlloc1d() and MbufAlloc2d() to create single band one- or two-dimensional data buffers, respectively.
After allocating a buffer, we recommend that you check if the operation was successful, using MappGetError(), or by verifying that the buffer identifier returned is not M_NULL.
When a buffer is no longer required, release it, using MbufFree().
For more information about color buffer formats, refer to the RGB buffers section and the YUV buffers section of Chapter 19: Data buffers.
Specifies the MIL system on which to allocate the buffer. This parameter should be set to one of the following values:
For specifying the MIL
system
|
|||||||||||||||||||||||||||||||||||||||
Value | Description
|
||||||||||||||||||||||||||||||||||||||
M_DEFAULT_HOST |
Specifies the default Host system of the current MIL application. |
||||||||||||||||||||||||||||||||||||||
MIL system identifier |
Specifies a valid system identifier, previously allocated using MsysAlloc(). |
Specifies the number of (x,y) surfaces (also called color bands) to allocate to the buffer. Specify one band for each of the color components that the buffer needs to store (for example, monochrome images require one band; RGB color images require three color bands). This parameter can be set to any non-zero integer value. However, in general, only 1- and 3-band buffers are allowed.
Specifies the buffer width. The units are determined by the selected buffer attribute. For example, if the buffer has an image buffer attribute, width is specified in pixels.
When dealing with monochrome (1-band) buffers, the buffer width must be a multiple of 4.
Specifies the buffer height. The units are determined by the selected buffer attribute. For example, if the buffer has an image buffer attribute, height is specified in pixels.
Specifies a combination of two values: data type and data depth per band. Specify the depth of the buffer per band as one of the following:
For the data depth of the
buffer
|
|||||||||||||||||||||||||||||||||||||||
Value | Description
|
||||||||||||||||||||||||||||||||||||||
1 + |
Specifies a 1-bit (packed binary) buffer. (more details...) |
||||||||||||||||||||||||||||||||||||||
8 + |
Specifies an 8-bit buffer. |
||||||||||||||||||||||||||||||||||||||
16 + |
Specifies a 16-bit buffer. |
||||||||||||||||||||||||||||||||||||||
32 + |
Specifies a 32-bit buffer. |
You can add one of the following values to the above-mentioned values to set the data type.
Supported data types depend on the specified depth.
For specifying the data type of the
buffer
|
|||||||||||||||||||||||||||||||||||||||
Combination value | Description
|
||||||||||||||||||||||||||||||||||||||
M_FLOAT |
Specifies that the type of data is floating-point. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_SIGNED |
Specifies that the type of data is signed. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_UNSIGNED |
Specifies that the type of data is unsigned. (more details...) |
Specifies the buffer usage. MIL uses this information to determine where to allocate the buffer in physical memory.
Set this parameter to one of the following values:
For specifying the buffer
usage
|
|||||||||||||||||||||||||||||||||||||||
Value |
Description
|
MIL system-specific tooltip (†) |
|||||||||||||||||||||||||||||||||||||
M_ARRAY + |
Specifies a buffer to store array type data. (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_IMAGE + |
Specifies a buffer to store image data. (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
Only single-band (monochrome) buffers with a depth of 8 or 16 bits can have an M_IMAGE attribute. Only three-band (BGR) unsigned packed buffers with a depth of 8 bits (M_BGR32) can have an M_IMAGE attribute. |
† | d | |||||||||||||||||||||||||||||||||||||
M_LUT + |
Specifies a buffer to store lookup table data. (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s |
You must add one or more of the following values to the above-mentioned value to set the intended purpose of the image buffer.
For specifying the intended purpose of
the image buffer
|
|||||||||||||||||||||||||||||||||||||||
Combination value |
Description
|
MIL system-specific tooltip (†) |
|||||||||||||||||||||||||||||||||||||
M_COMPRESS + |
[For
essential MIL-Lite information, see remarks ]
Specifies an image buffer that can hold compressed data. (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_DISP |
Specifies an image buffer that can be displayed. |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_GRAB |
Specifies an image buffer in which to grab data. (more details...) |
† | a | b | c | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | |||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
Only single-band (monochrome) buffers with a depth of 8 or 16 bits can have an M_GRAB attribute. |
† | c | j | k | l | m | o | p | q | r | s | ||||||||||||||||||||||||||||
Only single-band (monochrome) buffers with a depth of 8 bits can have an M_GRAB attribute. |
† | b | g | h | n | ||||||||||||||||||||||||||||||||||
Only single-band (monochrome) planar (M_PLANAR) buffers with a depth of 8 bits can have an M_GRAB attribute. Only 3-band BGR (color) packed buffers with a depth of 32 bits can have an M_GRAB attribute (that is 32-bit buffers allocated with M_GRAB + M_BGR32 + M_PACKED). Note that 3-band buffers are only available when using a Matrox Iris GT300C, GT1200C, or GT1900C. |
† | f | |||||||||||||||||||||||||||||||||||||
M_PROC + |
Specifies an image buffer that can be processed. |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s |
You can add the following value to the above-mentioned value to set the allocation of an overscan region.
This overrides the MsysControl() M_ALLOCATION_OVERSCAN system control setting and forces the allocation of an overscan region. When this attribute is set, the setting of the M_ALLOCATION_OVERSCAN_SIZE system control determines the size of the overscan region and the M_ALLOCATION_OVERSCAN setting is ignored.
Note that this attribute is only useful when added to a buffer on which you want to perform neighborhood processing operations.
For allocating an overscan
region
|
|||||||||||||||||||||||||||||||||||||||
Combination value | Description
|
||||||||||||||||||||||||||||||||||||||
M_ALLOCATION_OVERSCAN |
Specifies that the buffer is allocated with an overscan region. (more details...) |
You can add one of the following values to the above-mentioned value to set the compression type.
The image buffer's data depth dictates which compression type can be selected.
For specifying the compression
type INQ
|
|||||||||||||||||||||||||||||||||||||||
Combination value | Description
|
||||||||||||||||||||||||||||||||||||||
M_H264 |
[For
essential MIL-Lite information, see remarks ]
Specifies that the buffer will be used to hold H.264 data. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_JPEG2000_LOSSLESS |
[For
essential MIL-Lite information, see remarks ]
Specifies that the buffer will be used to hold JPEG2000 lossless data. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_JPEG2000_LOSSY |
[For
essential MIL-Lite information, see remarks ]
Specifies that the buffer will be used to hold JPEG2000 lossy data. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_JPEG_LOSSLESS |
[For
essential MIL-Lite information, see remarks ]
Specifies that the buffer will be used to hold JPEG lossless data. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_JPEG_LOSSLESS_INTERLACED |
[For
essential MIL-Lite information, see remarks ]
Specifies that the buffer will be used to hold JPEG lossless data in separate fields. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_JPEG_LOSSY |
[For
essential MIL-Lite information, see remarks ]
Specifies that the buffer will be used to hold JPEG lossy data. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_JPEG_LOSSY_INTERLACED |
[For
essential MIL-Lite information, see remarks ]
Specifies that the buffer will be used to hold JPEG lossy data in separate fields. (more details...) |
You can add one of the following values to the above-mentioned value to set a storage format and a location specifier.
MIL automatically selects the most appropriate storage format according to the specified intended usage attribute. For general processing, MIL will convert the data when the function requires a different format. If the default storage format is not appropriate and you want to avoid conversion during a time critical operation, you can add a storage format and a location specifier.
For specifying a storage format
and a location specifier
|
|||||||||||||||||||||||||||||||||||||||
Combination value | Description
|
MIL system-specific tooltip (†) |
|||||||||||||||||||||||||||||||||||||
M_DIB | † | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | |||||||||||||||||||
M_DIRECTX |
[This is
only applicable to Windows]
Forces the buffer to be a DirectX surface. |
† | a | b | c | d | e | g | h | i | j | k | l | m | n | o | p | q | r | s | |||||||||||||||||||
M_GDI |
Forces the buffer to be compatible with GDI. (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_LINUX_MXIMAGE |
[This is
only applicable to Linux]
Forces the buffer to be an X11 Ximage. |
† | a | b | c | d | e | g | h | i | j | k | l | m | n | o | p | q | r | s |
You can add the following value to the above-mentioned values to set a location for a buffer that is FPGA accessible.
Note that the following value cannot be used with M_COMPRESS or values in the For specifying a storage format and a location specifier table.
For specifying that the buffer is
FPGA accessible
|
|||||||||||||||||||||||||||||||||||||||
Combination value | Description
|
MIL system-specific tooltip (†) |
|||||||||||||||||||||||||||||||||||||
M_FPGA_ACCESSIBLE + |
Forces the buffer to be allocated in a bank of memory that is accessible from the Processing FPGA. (more details...) |
† | j | l | m | p | r |
You can add one of the following values to the above-mentioned value to set a storage format for color buffers.
Note that the buffer must be a color buffer. Also note that it might be slower to use buffers that have been forced with one of these attributes. Although there is no right or wrong storage format to use, certain operations are optimized for some formats.
For specifying a storage format
for color buffers INQ
|
|||||||||||||||||||||||||||||||||||||||
Combination value |
Description
|
MIL system-specific tooltip (†) |
|||||||||||||||||||||||||||||||||||||
M_PACKED + |
Specifies that the buffer's bands are stored in packed format (color buffer only); that is, the pixel components are stored together (RGB RGB RGB...). (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
Only 3-band BGR (color) packed buffers with a depth of 32 bits can have an M_GRAB attribute (that is 32-bit buffers allocated with M_GRAB + M_BGR32 + M_PACKED). Note that 3-band buffers are only available when using a Matrox Iris GT300C, GT1200C, or GT1900C. |
† | f | |||||||||||||||||||||||||||||||||||||
M_PLANAR + |
Specifies that the buffer's bands are stored in planar format (color buffer only); that is, each pixel is stored as three component planes (RRR... GGG... BBB...). (more details...) |
† | a | b | d | e | f | g | h | i | j | k | l | m | n | p | q | r | |||||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
Only single-band (monochrome) planar buffers with a depth of 8 bits can have an M_GRAB attribute. |
† | f |
You can add one of the following values to the above-mentioned value to set a planar color buffer format.
Note that the values below cannot be used with grab buffers (M_GRAB), unless otherwise stated.
Note that the following color buffer formats are only available when using a Matrox Iris GT300C, GT1200C, and GT1900C.
For specifying a planar color
buffer format
|
|||||||||||||||||||||||||||||||||||||||
Combination value | Description
|
MIL system-specific tooltip (†) |
|||||||||||||||||||||||||||||||||||||
M_RGB3 |
Specifies 3-bit color depth (RGB 1:1:1) planar pixels. |
† | a | b | d | e | f | g | h | i | j | k | l | m | n | p | q | r | |||||||||||||||||||||
M_RGB96 |
Specifies 96-bit color depth (RGB 32:32:32) planar pixels. |
† | a | b | d | e | f | g | h | i | j | k | l | m | n | p | q | r | |||||||||||||||||||||
M_YUV9 |
Specifies YUV9 planar pixels. |
† | a | b | d | e | f | g | h | i | j | k | l | m | n | p | q | r | |||||||||||||||||||||
M_YUV12 |
Specifies YUV12 planar pixels. |
† | a | b | d | e | f | g | h | i | j | k | l | m | n | p | q | r | |||||||||||||||||||||
M_YUV24 |
Specifies YUV24 planar pixels. |
† | a | b | d | e | f | g | h | i | j | k | l | m | n | p | q | r |
You can add one of the following values to the above-mentioned value to set a packed color buffer format.
Note that the values below cannot be used with grab buffers (M_GRAB), unless otherwise stated.
Note that these color buffer formats are only available when using a Matrox Iris GT300C, GT1200C, and GT1900C.
For specifying a packed color
buffer format
|
|||||||||||||||||||||||||||||||||||||||
Combination value |
Description
|
MIL system-specific tooltip (†) |
|||||||||||||||||||||||||||||||||||||
M_BGR24 |
Specifies 24-bit color depth packed pixels (BGRBGR). (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | o | p | q | r | s | |||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
This value can be used with grab (M_GRAB) buffers. |
† | a | b | c | e | g | h | i | j | k | l | m | o | p | q | r | s | ||||||||||||||||||||||
M_BGR32 |
Specifies 32-bit color depth packed pixels (BGRXBGRX). (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
This value can be used with grab (M_GRAB) buffers. |
† | a | b | c | e | g | h | i | j | k | l | m | n | o | p | q | r | s | |||||||||||||||||||||
This value can be used with packed (M_PACKED) grab (M_GRAB) buffers only if a color DCF is used during the grab. |
† | f | |||||||||||||||||||||||||||||||||||||
M_RGB15 |
Specifies 16-bit color depth packed pixels (XRGB 1:5:5:5). (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_RGB16 |
Specifies 16-bit color depth packed pixels (RGB 5:6:5). (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
M_YUV16_UYVY |
Specifies YUV16 packed (4:2:2) pixels, whereby the components of each pixel are stored in the UYVY order. (more details...) |
† | c | e | o | s | |||||||||||||||||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
This value can be used with grab (M_GRAB) buffers. |
† | c | o | s | |||||||||||||||||||||||||||||||||||
M_YUV16_YUYV |
Specifies YUV16 packed (4:2:2) pixels, whereby the components of each pixel are stored in the YUYV order. (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
This value can be used with grab (M_GRAB) buffers. |
† | a | b | e | g | h | i | j | k | l | m | n | p | q | r |
You can add one of the following values to the above-mentioned values to set a packed or planar color buffer format.
Note that the values below cannot be used with grab buffers (M_GRAB), unless otherwise stated.
Note that the following color buffer formats are only available when using a Matrox Iris GT300C, GT900C, and GT1200C.
For specifying a packed or planar
color buffer format
|
|||||||||||||||||||||||||||||||||||||||
Combination value |
Description
|
MIL system-specific tooltip (†) |
|||||||||||||||||||||||||||||||||||||
M_RGB24 |
Specifies 24-bit color depth (RGB 8:8:8) packed or planar pixels. (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
This value can be used with planar (M_PLANAR) grab (M_GRAB) buffers. |
† | j | k | l | m | p | q | r | |||||||||||||||||||||||||||||||
This value can be used with Host (M_HOST_MEMORY) planar (M_PLANAR) grab (M_GRAB) buffers. |
† | n | |||||||||||||||||||||||||||||||||||||
This value can be used with packed (M_PACKED) grab (M_GRAB) buffers. |
† | c | e | n | o | s | |||||||||||||||||||||||||||||||||
M_RGB48 |
Specifies 48-bit color depth (RGB 16:16:16). (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
This value can be used with packed (M_PACKED) grab (M_GRAB) buffers. |
† | c | j | k | l | m | o | p | q | r | s | ||||||||||||||||||||||||||||
This value can be used with planar (M_PLANAR) grab (M_GRAB) buffers if the buffer is allocated on the Host (M_HOST_MEMORY) and not on-board. |
† | j | k | l | m | p | q | r | |||||||||||||||||||||||||||||||
M_YUV16 |
Specifies YUV16 (4:2:2) pixels. (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
This value can be used with packed (M_PACKED) grab (M_GRAB) buffers. |
† | a | b | c | e | g | h | i | j | k | l | m | n | o | p | q | r | s |
You can add one of the following values to the above-mentioned values to set a location for a buffer.
For specifying a location for a
buffer
|
|||||||||||||||||||||||||||||||||||||||
Combination value |
Description
|
MIL system-specific tooltip (†) |
|||||||||||||||||||||||||||||||||||||
M_HOST_MEMORY + |
Forces the buffer in Host memory. (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
This is a MIL system specific default value. | † | a | b | c | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||||
M_MAPPABLE |
Forces the buffer to be allocated in non-paged memory that can be set in the address space of the process (Host memory). (more details...) |
† | a | b | c | e | f | g | h | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||||
M_OFF_BOARD |
Ensures that the buffer is not in on-board memory. (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
To ensure that an M_OFF_BOARD buffer can be used by the bus master transfer section of the board, the buffer must be allocated in non-paged memory (M_OFF_BOARD + M_NON_PAGED or M_HOST_MEMORY + M_NON_PAGED). |
† | f | g | h | j | k | l | m | n | p | q | r | |||||||||||||||||||||||||||
M_ON_BOARD + |
Forces the buffer in on-board memory. (more details...) |
† | f | g | h | i | j | k | l | m | n | p | q | r | |||||||||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
By default, all on-board buffers are allocated in memory that is not mapped on the PCI bus. This unshared memory cannot be accessed by the Host or any system other than the one on which it was allocated. See combination values below (M_SHARED) to change this default behavior. |
† | j | k | l | m | p | q | r | |||||||||||||||||||||||||||||||
This is only available for grab buffers (M_GRAB). |
† | f | |||||||||||||||||||||||||||||||||||||
This is only available for image buffers (M_IMAGE). |
† | g | h | i | k | n | |||||||||||||||||||||||||||||||||
This is only available for image (M_IMAGE) and LUT buffers (M_LUT). |
† | j | l | m | p | q | r | ||||||||||||||||||||||||||||||||
M_VIDEO_MEMORY |
[This is
only applicable to Windows]
Forces the buffer in (off-screen) display memory of your graphics controller. (more details...) |
† | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | ||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
Buffers cannot be allocated in display memory when any of the following attributes are used: M_COMPRESS, M_DIB, M_GDI, or M_NON_PAGED. |
† | d | |||||||||||||||||||||||||||||||||||||
This is a MIL system specific default value. | † | d |
You can add the following value to the above-mentioned values to specify a memory bank to be used.
For specifying a memory bank to
be used
|
||||||||||||||||||||||||||||||||||||||||||
Combination value |
Description
|
MIL system-specific tooltip (†) |
||||||||||||||||||||||||||||||||||||||||
M_MEMORY_BANK_n |
Forces the buffer to be allocated in the specified memory bank. (more details...) |
† | † | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o | p | q | r | s | |
Operating system specific | ||||||||||||||||||||||||||||||||||||||||||
[This is
only applicable to Windows]
Valid values for n are between 0 and 6, inclusive. However, not all memory banks are necessarily present on a given system. Typically, if there is more than 1 memory bank, it is NUMA-enabled. Note that, to ensure that you are accessing a NUMA-enabled memory bank, you must specify the M_HOST_MEMORY combination value. To determine the actual number of memory banks available on the MIL system, use MappInquireMp() with M_MEMORY_BANK_NUM and MappInquireMp() with M_MEMORY_BANK_AFFINITY_MASK. For more information, refer to the NUMA Support subsection of the Transparent multi-core use section of Chapter 30: Multi-processing, multi-core, and multi-threading. Note that this value cannot be used with M_COMPRESS or M_NON_PAGED. Also note that the combination of M_HOST_MEMORY with this value, in paged memory, is only useful when doing multi-core processing on a Host system. |
||||||||||||||||||||||||||||||||||||||||||
[This is
only applicable to Linux]
Note that this value is not available with the M_HOST_MEMORY combination value. |
||||||||||||||||||||||||||||||||||||||||||
MIL system specific | ||||||||||||||||||||||||||||||||||||||||||
Valid values for n are between 0 and 1, inclusive. Refer to your MIL Hardware-specific Notes for more information about on-board memory. Note that, to assure you are accessing an on-board memory bank, you must specify the M_ON_BOARD combination value.
|
† | j | p | r | ||||||||||||||||||||||||||||||||||||||
In this case, n must be set to 0. This is the default memory bank for an on-board buffer created with the M_GRAB attribute. Refer to your MIL Hardware-specific Notes for more information about on-board memory. Note that, to assure you are accessing an on-board memory bank, you must specify the M_ON_BOARD combination value. |
† | k | q | |||||||||||||||||||||||||||||||||||||||
Valid values for n are between 0 and 2, inclusive. Refer to your MIL Hardware-specific Notes for more information about on-board memory. Note that, to assure you are accessing an on-board memory bank, you must specify the M_ON_BOARD combination value.
|
† | l | m |
You can add one of the following values to the above-mentioned values to set a location in a specific type of memory.
For specifying a location in a
specific type of memory
|
|||||||||||||||||||||||||||||||||||||||
Combination value |
Description
|
MIL system-specific tooltip (†) |
|||||||||||||||||||||||||||||||||||||
M_FAST_MEMORY |
Specifies that the buffer is in the fastest memory available. (more details...) |
† | j | l | m | p | r | ||||||||||||||||||||||||||||||||
MIL system specific | |||||||||||||||||||||||||||||||||||||||
For Matrox Solios eA/XA and eCL/XCL, the fasted memory available is the SRAM. If SRAM is not present on your Matrox Solios, SDRAM will be used instead. This value is typically the same as using M_MEMORY_BANK_2. |
† | l | m | ||||||||||||||||||||||||||||||||||||
For Matrox Radient, the fasted memory available is the SRAM. If SRAM is not present on your Matrox Radient, SDRAM will be used instead. This value is typically the same as using M_MEMORY_BANK_1. |
† | j | p | r | |||||||||||||||||||||||||||||||||||
M_SHARED |
Specifies that the buffer is in shared processing memory. (more details...) |
† | j | k | l | m | p | q | r |
You can add one of the following values to the above-mentioned values to set the attribute of the specified physical memory type.
For specifying the attribute of
the specified physical memory type
|
|||||||||||||||||||||||||||||||||||||||
Combination value | Description
|
||||||||||||||||||||||||||||||||||||||
M_NON_PAGED |
Forces the buffer in MIL-reserved, non-pageable memory. |
||||||||||||||||||||||||||||||||||||||
M_PAGED |
Forces the buffer in pageable memory. |
Header | Include mil.h. |
Library | Use mil.lib. |
DLL | Requires mil.dll. |