| MIL 10 Reference
| Customize Help
| Save Settings

MseqAlloc


See also
Availability
Available in MIL-Lite with restrictions (see remarks)
Available in MIL

Available on Windows
Not available on Linux

Available on Non-Matrox computer
Available on Matrox 4Sight-X
Available on Matrox 4Sight GP
Available on Matrox Supersight
function map Function map
Examples
Previous
MseqControl
Synopsis
Allocate a sequence context.
Syntax
MIL_ID MseqAlloc(
MIL_ID SystemId, //in
MIL_INT64 SequenceType, //in
MIL_INT64 Operation, //in
MIL_UINT32 OutputFormat, //in
MIL_INT64 InitFlag, //in
MIL_ID *ContextSeqIdPtr //out
)
Description

This function allocates a sequence context on the specified system. A sequence context establishes the sequence operation that should be performed when a sequence processing operation is started using MseqProcess() and contains all the information necessary to perform it. When the sequence context is no longer required, you should release its memory, using MseqFree().

Define the source of an input or the destination(s) of an output for a sequence operation using MseqDefine(). Specify the operation settings of the sequence operation and adjust the settings of the source(s) and destination(s) using MseqControl().

H.264 video encoding is optimized for Intel CPUs and can be subject to performance and stability issues when used with other CPUs.

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 if there is complementary information.
Parameters
This function is not supported on the selected boards.
Parameters
SystemId

Specifies the system on which to allocate the sequence context. This parameter should be set to one of the following values:

function map For specifying the system
CollapseValue Description
Collapse M_DEFAULT_HOST

Specifies the default Host system of the current MIL application.
Collapse MIL system identifier

Specifies a valid system identifier, previously allocated using MsysAlloc().
SequenceType

Reserved for future expansion. This parameter must be set to M_DEFAULT.

Operation

Specifies the operation that the sequence processing session should perform.

function map For specifying the operation performed by the sequence processing session
CollapseValue Description
Collapse M_SEQ_COMPRESS

Specifies that the sequence processing operation will compress a sequence of images into an H.264 elementary video stream.
Collapse M_SEQ_DECOMPRESS

Specifies that the sequence processing operation will decompress an H.264 elementary video stream.
OutputFormat

Specifies the format to use to create the internal output buffer.

function map For specifying the output format to use
CollapseValue Description
Collapse M_DEFAULT

Specifies the default output format. For example, for a compression operation, the format is H.264.

(summarize)
InitFlag INQ

Specifies the underlying hardware or software used for the operation.

function map For specifying the underlying hardware or software used for the operation.
CollapseValue Description
Collapse M_DEFAULT
[For essential MIL-Lite information, see remarks ]

Same as M_QSV.
Collapse M_QSV +
[For essential MIL-Lite information, see remarks ]

Specifies to perform the operation using the Intel QSV engine. If your processor does not have a QSV engine, MIL will perform the operation in software. You can force the operation to be performed in hardware or software by combining M_QSV with M_HARDWARE or M_SOFTWARE, respectively.

(summarize)
Combination constants that can be used alone or as combination constants for M_QSV.

You can use one of the following values on its own, or add it to the above-mentioned value, to set whether the operation will be performed in hardware or software.

function map For specifying whether the operation is performed in hardware or software
CollapseValue Description
Collapse M_HARDWARE

Specifies to perform the operation in hardware; MIL will select the first hardware accelerated device it detects. If no hardware acceleration is present on your computer, an error is generated.

(summarize)
Collapse M_SOFTWARE

Specifies to perform the operation in software.
ContextSeqIdPtr

Specifies the address of the variable in which to write the sequence context identifier. Since the MseqAlloc() function also returns the sequence context identifier, you can set this parameter to M_NULL. If allocation fails, M_NULL is written as the identifier.

Return value
The returned value is the sequence context's identifier. If allocation fails, M_NULL is returned.
Remark
  • [MIL-Lite]
    Note that during development and at runtime, compression support, particularly for an M_QSV buffer type, requires the presence of a MIL license that grants access to the compression/decompression package. This access is only granted by default with the development license dongle for the full version of MIL. In other cases, you must purchase access to this package separately.
Compilation information
Header Include mil.h.
Library Use mil.lib.
DLL Requires mil.dll.
DEFAULT HOST SEQ COMPRESS SEQ DECOMPRESS DEFAULT DEFAULT QSV HARDWARE SOFTWARE