| Customize Help
| Save Settings

MseqAlloc


Function Map
Syntax
Description
Parameters
- 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 which MIL system’s documentation you should use in its place and any possible differences.
Parameters
This function is not supported on the selected boards.
This function reference has not been updated for the selected MIL system. To show the content of this page, choose a second MIL system; refer to the MIL system's release note to see which MIL system’s documentation to choose and any possible differences.
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
Click to summarizeValue Description
Click to summarize M_DEFAULT_HOST

Specifies the default Host system of the current MIL application.
Click to summarize 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
Click to summarizeValue Description
Click to summarize M_SEQ_COMPRESS

Specifies that the sequence processing operation will compress a sequence of images into an H.264 elementary video stream.
Click to summarize 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
Click to summarizeValue Description
Click to summarize 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.
Click to summarizeValue Description
Click to summarize M_DEFAULT
[For essential MIL-Lite information, see remarks ]

Same as M_QSV.
Click to summarize 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 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.

function map For specifying whether the operation is performed in hardware or software
Click to summarizeValue Description
Click to summarize 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)
Click to summarize 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