MseqAlloc

Filters
See also

User Guide:

Compressing and decompressing a sequence of images Steps to performing a sequence operation

Reference:

MseqControl MseqDefine MseqFree MseqProcess MsysAlloc

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/GPm

Available on Matrox Supersight

Function map

Examples

mseqprocess.cpp
mseqprocess.cs
mseqprocess.vb

Function Map

- SystemId

Table:

For specifying the system

- SequenceType

- Operation

Table:

For specifying the operation performed by the sequence processing session

- OutputFormat

Table:

For specifying the output format to use

- InitFlag

Table:	For specifying the underlying hardware or software used for the operation.
+ combination:	For specifying whether the operation is performed in hardware or software

- ContextSeqIdPtr

Return value

Remarks

Compilation information

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:

For specifying the 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().

SequenceType

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

Operation

Specifies the operation that the sequence processing session should perform.

For specifying the operation performed by the sequence processing session
Value	Description
M_SEQ_COMPRESS	Specifies that the sequence processing operation will compress a sequence of images into an H.264 elementary video stream.
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.

For specifying the output format to use
Value	Description
M_DEFAULT	Specifies the default output format. For example, for a compression operation, the format is H.264. (summarize) Specifies the default output format. (more details...)

InitFlag INQ

Specifies the underlying hardware or software used for the operation.

For specifying the underlying hardware or software used for the operation.
Value	Description
M_DEFAULT	[For essential MIL-Lite information, see remarks ] Same as M_QSV.
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) [For essential MIL-Lite information, see remarks ] Specifies to perform the operation using the Intel QSV engine. (more details...)

Combination values that can be used alone or as combination values 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.

For specifying whether the operation is performed in hardware or software
Value	Description
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) Specifies to perform the operation in hardware; MIL will select the first hardware accelerated device it detects. (more details...)
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.