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.

 

 

Asynchronous operation related errors or warnings

 

 

MFX_ERR_ABORTED

The asynchronous operation aborted.

 

 

MFX_ERR_MORE_DATA

Need more bitstream at decoding input, encoding input, or video processing input frames.

 

 

MFX_ERR_MORE_SURFACE

Need more frame surfaces at decoding or video processing output

 

 

MFX_ERR_MORE_BITSTREAM

Need more bitstream buffers at the encoding output

 

 

MFX_WRN_IN_EXECUTION

Synchronous operation still running

 

 

Hardware device related errors or warnings

 

 

MFX_ERR_DEVICE_FAILED

Hardware device returned unexpected errors. SDK was unable to restore operation. See section Hardware Device Error Handling for more information.

 

 

MFX_ERR_DEVICE_LOST

Hardware device was lost; See the Hardware Device Error Handling section for further information.

 

 

MFX_WRN_DEVICE_BUSY

Hardware device is currently busy. Call this function again in a few milliseconds.

 

 

MFX_WRN_PARTIAL_ACCELERATION

The hardware does not support the specified configuration. Encoding, decoding, or video processing may be partially accelerated. Only SDK HW implementation may return this status code.

 

 

MFX_ERR_GPU_HANG

Hardware device operation failure caused by GPU hang.

 

Change History

 

This enumerator is available since SDK API 1.0. SDK API 1.3 added the MFX_ERR_MORE_BITSTREAM return status. SDK API 1.6 added the MFX_WRN_FILTER_SKIPPED return status.

The SDK API 1.19 added MFX_ERR_GPU_HANG and MFX_ERR_REALLOC_SURFACE.

 

 

 

 

 

Para obter informações mais completas sobre otimizações do compilador, consulte nosso aviso de otimização.