This is a computer translation of the original content. It is provided for general information only and should not be relied upon as complete or accurate.

Sorry, we can't translate this content right now, please try again later.

mfxStatus

Description

The mfxStatus enumerator itemizes status codes returned by SDK functions.

When an SDK function returns an error status code, it generally expects a Reset or Close function to follow, (with the exception of MFX_ERR_MORE_DATA and MFX_ERR_MORE_SURFACE for asynchronous operation considerations) See section Decoding Procedures, section Encoding Procedures, and section Video Processing Procedures for more information about recovery procedures.

When an SDK function returns a warning status code, the function has performed necessary operations to continue the operation without interruption. In this case, the output might be unreliable. The application must check the validity of the output generated by the function.

Name/Description

Successful operation

MFX_ERR_NONE

No error

Reserved status code

MFX_ERR_UNKNOWN

An unknown error occurred in the library function operation. This is a reserved status code.

Programming related errors

MFX_ERR_NOT_INITIALIZED

Member functions called without initialization.

MFX_ERR_INVALID_HANDLE

Invalid session or MemId handle

MFX_ERR_NULL_PTR

NULL pointer in the input or output arguments

MFX_ERR_UNDEFINED_BEHAVIOR

The behavior is undefined.

MFX_ERR_NOT_ENOUGH_BUFFER

Insufficient buffer for input or output.

MFX_ERR_NOT_FOUND

Specified object/item/sync point not found.

Memory related errors

MFX_ERR_MEMORY_ALLOC

Failed to allocate memory.

MFX_ERR_LOCK_MEMORY

Failed to lock the memory block (external allocator).

MFX_ERR_REALLOC_SURFACE

Bigger output surface required.

Configuration related errors or warnings

MFX_ERR_UNSUPPORTED

Unsupported configurations, parameters, or features

MFX_ERR_INVALID_VIDEO_PARAM

Invalid video parameters detected. Init and Reset functions return this status code to indicate either that mandated input parameters are unspecified, or the functions failed to correct them.

MFX_ERR_INCOMPATIBLE_VIDEO_PARAM

Incompatible video parameters detected. If a Reset function returns this status code, a component—decoder, encoder or video preprocessor—cannot process the specified configuration with existing structures and frame buffers. If the function MFXVideoDECODE_DecodeFrameAsync returns this status code, the bitstream contains an incompatible video parameter configuration that the decoder cannot follow.

MFX_WRN_VIDEO_PARAM_CHANGED

The decoder detected a new sequence header in the bitstream. Video parameters may have changed.

MFX_WRN_VALUE_NOT_CHANGED

The parameter has been clipped to its value range.

MFX_WRN_OUT_OF_RANGE

The parameter is out of valid value range.

MFX_WRN_INCOMPATIBLE_VIDEO_PARAM

Incompatible video parameters detected. SDK functions return this status code to indicate that there was incompatibility in the specified parameters and has resolved it.

MFX_WRN_FILTER_SKIPPED

The SDK VPP has skipped one or more optional filters requested by the application. To retrieve actual list of filters attach mfxExtVPPDoUse to mfxVideoParam and call MFXVideoVPP_GetVideoParam. The application must ensure that enough memory is allocated for filter list.