Error Codes

The LEADTOOLS Multimedia toolkit returns error and success notifications to applications in the form of HRESULT values.

A return code's LOWORD portion is the return code itself, in hexadecimal format.

The COM Win32 HRESULT documentation contains more information, including how to use the FAILED and SUCCEEDED macros to test return values.

The LEADTOOLS Multimedia filters will return E_EVAL_EXPIRED (0x80050010) if you attempt to create them after the evaluation period has expired.

The LEADTOOLS Multimedia toolkit functions will often return error codes native to DirectShow. Refer to the Microsoft DirectX SDK for specific information about DirectShow error codes.

Some Multimedia components, such as the DVD Writer, will convert DOS error codes to 0x8003zzzz, where "zzzz" is the error code. For example, the DOS error code ERROR_PATH_NOT_FOUND (0x03) is converted to 0x80030003. For a complete list, see the GetLastError function in the Microsoft Platform SDK documentation.

Code Value Description
LTMM_E_REBUILDNEEDED 0x80050012 The graph has changed - it should be rebuilt.
LTMM_E_INVALID_DATA 0x80050013 Invalid data.
LTMM_E_INVALID_HEADER 0x80050014 Invalid packed data.
LTMM_E_DISABLED 0x80050015 This feature is disabled.
LTMM_E_INVALID_VERSION 0x80050016 This version is not supported.
LTMM_E_STILLIMAGE_LOCKED 0x80050017 The LEADTOOLS still image toolkit needs to be unlocked.
LTMM_E_STILLIMAGE_MISSING 0x8005001A One or more raster LEADTOOLS modules are missing.
LTMM_E_BADURL_OPTIONS 0x8005001B The options passed in the URL are invalid.
LTMM_E_LOGGING_NOT_STARTED 0x8005001D Logging needs to have started to call this method.
LTMM_E_CUDA_FAILED_CREATE_HWENCODER 0x8005001F (Internal) failed to create CUDA Hardware Encoder.
LTMM_E_DVR_DISCARDED_DATA 0x80050020 You are trying to read discarded data.
LTMM_E_DVR_NO_RECORDINGS 0x80050021 There are no recordings in the stub file.
LTMM_E_DVR_CORRUPT_STUB_FILE 0x80050022 The stub file is corrupt.
LTMM_E_DVR_STOPPED 0x80050023 The DVR has stopped writing data.
LTMM_E_DVR_CHANGING_ATTRIBUTES 0x80050025 The DVR sink is changing attributes.
LTMM_E_DVR_SUSPENDED 0x80050026 Reading for current sample is temporarily suspended.
LTMM_E_DVR_RECORDINGINUSE 0x80050027 The recording I am trying to create is in use.
LTMM_E_RTSP_PARSING_STREAM 0x80050030 An error has occurred parsing the stream description.
LTMM_E_RTSP_DESCRIBE_FAILED 0x80050031 The DESCRIBE RTSP command has failed.
LTMM_E_RTSP_SETUP_FAILED 0x80050032 The SETUP RTSP command has failed.
LTMM_E_RTSP_PLAY_FAILED 0x80050033 The PLAY RTSP command has failed.
LTMM_E_RTSP_PAUSE_FAILED 0x80050034 The PAUSE RTSP command has failed.
LTMM_E_RTSP_TEARDOWN_FAILED 0x80050035 The TEARDOWN RTSP command has failed.
LTMM_E_RTSP_OPTIONS_FAILED 0x80050036 The OPTIONS RTSP command has failed.
LTMM_E_RTSP_UNAUTHORIZED 0x80050037 The command failed due to a bad username and/or password.
LTMM_E_RTSP_RECONNECT 0x80050038 Internal use - reconnect to the server.
LTMM_E_RTSP_URL_NOT_FOUND 0x80050039 The RTSP server does not contain this URL.
LTMM_E_RTSP_BAD_MEDIATYPE 0x8005003A The RTSP server is unable to stream this type of file. This error is generated by the server, not the LEAD filter.
LTMM_E_BAD_MULTICAST_ADDRESS 0x8005003B The RTSP server did not choose a valid multicast address.
LTMM_E_BAD_URL_OPTION 0x8005003C One of the options passed through the URL (eg: transport) is invalid.
LTMM_E_BAD_INTERLEAVE_OPTION 0x8005003D The RTSP server did not assign a valid interleave option.
LTMM_E_HTTP_GET_FAILED 0x8005003E The HTTP GET command has failed - the RTSP server probably does not support the HTTP mode.
LTMM_E_SERVER_NOT_RESPONDING 0x8005003F The server is not responding. Reconnection is advisable.
LTMM_E_ITEM_NOT_FOUND 0x80050040 The item was not found.
LTMM_E_TOO_MANY_CONNECTIONS 0x80050041 The maximum number of connections has been exceeded.
LTMM_E_NO_MEDIA 0x80050042 No media handler is available.
LTMM_E_BAD_COMMAND 0x80050043 Bad RTSP Command.
LTMM_E_MEDIA_NOT_SUPPORTED 0x80050044 This media is not supported.
LTMM_E_FIELD_NOT_FOUND 0x80050045 The field was not found.
LTMM_E_SESSION_NOT_FOUND 0x80050046 The RTSP session was not found.
LTMM_E_OPTION_NOT_SUPPORTED 0x80050047 The RTSP option is not supported.
LTMM_E_USER_EXISTS 0x80050049 The user already exists with a different password.
LTMM_E_AUTHENTICATION_REQUIRED 0x8005004A Authentication is required.
LTMM_E_RETRY_OTHER_TRANSPORT 0x8005004B Internal - retry connection with a different transport.
LTMM_E_CUDA_DEVICE_NOT_AVAILABLE 0x80050050 The specified CUDA device is not available.
LTMM_E_SSE4_NOT_AVAILABLE 0x80050051 This filter/operation requires processors with SSE4 capabilities.
LTMM_E_ABORT_WAIT_RESET_SOURCE 0x80050052 The wait for data operation was aborted because ResetSource was called while waiting for data.
LTMM_E_ABORT_WAIT_STOP 0x80050053 The wait for data operation was aborted because Stop was called while waiting for data.
LTMM_E_NO_SAMPLE_RETRY 0x80050054 Internal H264 decoder error.
LTMM_E_CUDA_OLD_VERSION 0x80050056 The CUDA engine is too old. Install a newer version of the display driver.
LTMM_E_CUDA_ERROR 0x80050057 An unspecified CUDA error has occurred.
LTMM_E_CUDA_TOO_MANY_CONTEXTS 0x80050058 Internal - There are too many active CUDA contexts.
LTMM_E_MAX_PINS_EXCEEDED 0x80050059 Internal - The maximum number of pins was exceeded.
LTMM_E_CUDA_DEVICE_CRASHED 0x8005005A The CUDA device crashed, so it will be disabled.
LTMM_E_CUDA_NVCUVENC_MISSING 0x8005005B NVCUVENC.DLL is missing, so the old NVCUVENC CUDA compression is not available.
LTMM_E_WMVCORE_MISSING 0x8005005C WMVCORE.DLL is missing. Install Windows Media Player to correct this.
LTMM_E_MULTIPASS_NOT_SUPPORTED 0x8005005D Multipass encoding is not supported.
LTMM_E_DICOM_MPEG2_STREAM_INCOMPATIBLE 0x8005005F The MPEG-2 stream is not DICOM compatible (Set compatibility to IGNORE to resolve).
LTMM_E_SCRAMBLED_CONTENT 0x80050060 The MPEG-2 streams are scrambled (encrypted).
LTMM_E_TOO_MANY_CONVERSIONS 0x80050061 Internal - too many color space conversions.
LTMM_E_STREAMS_ARE_TOO_FAR_APART 0x80050062 The drift correction mechanism has detected a large gap between the timestamps for audio and video streams. The capture device is most likely malfunctioning and you should restart the graph.
LTMM_S_PREROLL 0x5001C The Preroll sample was not delivered (Internal use).
LTMM_S_LOW_MEMORY_MODE 0x5001E (Internal) Just switched to low memory mode. All buffering will be dumped to disk from now on.
LTMM_S_DVR_WAITING 0x50024 The DVR source is waiting for data to be written to disk.
LTMM_S_RESPONSE_PENDING 0x50048 The response to the RTSP command has been sent or will be sent later.
LTMM_S_WRONG_STATE 0x50055 The change was successful, but will take effect the next time you run the graph. This is just a warning message, not an error.

The following list contains frequently encountered Microsoft/ DirectShow error codes. They are included here for your convenience. For a full list of Microsoft/ DirectShow error codes, refer to the Microsoft/ DirectShow documentation.

Code Value Description
VFW_S_DUPLICATE_NAME &H0004022D An attempt to add a filter with a duplicate name succeeded with a modified name.
VFW_S_STATE_INTERMEDIATE &H00040237 The state transition is not complete.
VFW_S_PARTIAL_RENDER &H00040242 Some of the streams in this movie are in an unsupported format.
VFW_S_SOME_DATA_IGNORED &H00040245 The file contained some property settings that were not used.
VFW_S_CONNECTIONS_DEFERRED &H00040246 Some connections failed and were deferred.
VFW_S_RESOURCE_NOT_NEEDED &H00040250 The resource specified is no longer needed.
VFW_S_MEDIA_TYPE_IGNORED &H00040254 Could not connect with the media type in the persistent graph.
VFW_S_VIDEO_NOT_RENDERED &H00040257 Cannot play back the video stream: could not find a suitable renderer.
VFW_S_AUDIO_NOT_RENDERED &H00040258 Cannot play back the audio stream: could not find a suitable renderer.
VFW_S_RPZA &H0004025A Cannot play back the video stream: format 'RPZA' is not supported.
VFW_S_ESTIMATED &H00040260 The value returned had to be estimated. Its accuracy cannot be guaranteed.
VFW_S_RESERVED &H00040263 This success code is reserved for internal purposes within DirectShow.
VFW_S_STREAM_OFF &H00040267 The stream was turned off.
VFW_S_CANT_CUE &H00040268 The filter is active, but cannot deliver data. See IMediaFilter::GetState in your SDK.
STG_E_PATHNOTFOUND &H80030003 Path not found.
VFW_E_INVALIDMEDIATYPE &H80040200 Specified media type is invalid.
VFW_E_INVALIDSUBTYPE &H80040201 Specified media subtype is invalid.
VFW_E_NEED_OWNER &H80040202 This object can only be created as an aggregated object.
VFW_E_ENUM_OUT_OF_SYNC &H80040203 The state of the enumerated object has changed and is now inconsistent with the state of the enumerator. Discard any data obtained from previous calls to the enumerator and then update the enumerator by calling the enumerator's Reset method.
VFW_E_ALREADY_CONNECTED &H80040204 At least one of the pins involved in the operation is already connected.
VFW_E_FILTER_ACTIVE &H80040205 Operation cannot be performed because the filter is active.
VFW_E_NO_TYPES &H80040206 One of the specified pins does not support media types.
VFW_E_NO_ACCEPTABLE_TYPES &H80040207 No common media type between these pins.
VFW_E_INVALID_DIRECTION &H80040208 Two pins of the same direction cannot be connected.
VFW_E_NOT_CONNECTED &H80040209 Operation cannot be performed because the pins are not connected.
VFW_E_NO_ALLOCATOR &H8004020A No sample buffer allocator is available.
VFW_E_RUNTIME_ERROR &H8004020B A run-time error occurred.
VFW_E_BUFFER_NOTSET &H8004020C No buffer space has been set.
VFW_E_BUFFER_OVERFLOW &H8004020D The buffer is not big enough.
VFW_E_BADALIGN &H8004020E An invalid alignment was specified.
VFW_E_ALREADY_COMMITTED &H8004020F Cannot change allocated memory while the filter is active.
VFW_E_BUFFERS_OUTSTANDING &H80040210 One or more buffers are still active.
VFW_E_NOT_COMMITTED &H80040211 Cannot allocate a sample when the allocator is not active.
VFW_E_SIZENOTSET &H80040212 Cannot allocate memory because no size has been set.
VFW_E_NO_CLOCK &H80040213 Cannot lock for synchronization because no clock has been defined.
VFW_E_NO_SINK &H80040214 Quality messages could not be sent because no quality sink has been defined.
VFW_E_NO_INTERFACE &H80040215 A required interface has not been implemented.
VFW_E_NOT_FOUND &H80040216 An object or name was not found.
VFW_E_CANNOT_CONNECT &H80040217 No combination of intermediate filters could be found to make the connection.
VFW_E_CANNOT_RENDER &H80040218 No combination of filters could be found to render the stream.
VFW_E_CHANGING_FORMAT &H80040219 Could not change formats dynamically.
VFW_E_NO_COLOR_KEY_SET &H8004021A No color key has been set.
VFW_E_NOT_OVERLAY_CONNECTION &H8004021B Current pin connection is not using the IOverlay transport.
VFW_E_NOT_SAMPLE_CONNECTION &H8004021C Current pin connection is not using the IMemInputPin transport.
VFW_E_PALETTE_SET &H8004021D Setting a color key would conflict with the palette already set.
VFW_E_COLOR_KEY_SET &H8004021E Setting a palette would conflict with the color key already set.
VFW_E_NO_COLOR_KEY_FOUND &H8004021F No matching color key is available.
VFW_E_NO_PALETTE_AVAILABLE &H80040220 No palette is available.
VFW_E_NO_DISPLAY_PALETTE &H80040221 Display does not use a palette.
VFW_E_TOO_MANY_COLORS &H80040222 Too many colors for the current display settings.
VFW_E_STATE_CHANGED &H80040223 The state changed while waiting to process the sample.
VFW_E_NOT_STOPPED &H80040224 The operation could not be performed because the filter is not stopped.
VFW_E_NOT_PAUSED &H80040225 The operation could not be performed because the filter is not paused.
VFW_E_NOT_RUNNING &H80040226 The operation could not be performed because the filter is not running.
VFW_E_WRONG_STATE &H80040227 The operation could not be performed because the filter is in the wrong state.
VFW_E_START_TIME_AFTER_END &H80040228 The sample start time is after the sample end time.
VFW_E_INVALID_RECT &H80040229 The supplied rectangle is invalid.
VFW_E_TYPE_NOT_ACCEPTED &H8004022A This pin cannot use the supplied media type.
VFW_E_SAMPLE_REJECTED &H8004022B This sample cannot be rendered.
VFW_E_SAMPLE_REJECTED_EOS &H8004022C This sample cannot be rendered because the end of the stream has been reached.
VFW_E_DUPLICATE_NAME &H8004022D An attempt to add a filter with a duplicate name failed.
VFW_E_TIMEOUT &H8004022E A time-out has expired.
VFW_E_INVALID_FILE_FORMAT &H8004022F The file format is invalid.
VFW_E_ENUM_OUT_OF_RANGE &H80040230 The list has already been exhausted.
VFW_E_CIRCULAR_GRAPH &H80040231 The filter graph is circular.
VFW_E_NOT_ALLOWED_TO_SAVE &H80040232 Updates are not allowed in this state.
VFW_E_TIME_ALREADY_PASSED &H80040233 An attempt was made to queue a command for a time in the past.
VFW_E_ALREADY_CANCELLED &H80040234 The queued command was already canceled.
VFW_E_CORRUPT_GRAPH_FILE &H80040235 Cannot render the file because it is corrupt.
VFW_E_ADVISE_ALREADY_SET &H80040236 An IOverlay advise link already exists.
VFW_E_NO_MODEX_AVAILABLE &H80040238 No full-screen modes are available.
VFW_E_NO_ADVISE_SET &H80040239 This advise cannot be canceled because it was not successfully set.
VFW_E_NO_FULLSCREEN &H8004023A Full-screen mode is not available.
VFW_E_IN_FULLSCREEN_MODE &H8004023B Cannot call IVideoWindow methods while in full-screen mode.
VFW_E_UNKNOWN_FILE_TYPE &H80040240 The media type of this file is not recognized.
VFW_E_CANNOT_LOAD_SOURCE_FILTER &H80040241 The source filter for this file could not be loaded.
VFW_E_FILE_TOO_SHORT &H80040243 A file appeared to be incomplete.
VFW_E_INVALID_FILE_VERSION &H80040244 The file's version number is invalid.
VFW_E_INVALID_CLSID &H80040247 This file is corrupt: it contains an invalid class identifier.
VFW_E_INVALID_MEDIA_TYPE &H80040248 This file is corrupt: it contains an invalid media type.
VFW_E_SAMPLE_TIME_NOT_SET &H80040249 No time stamp has been set for this sample.
VFW_E_MEDIA_TIME_NOT_SET &H80040251 No media time was set for this sample.
VFW_E_NO_TIME_FORMAT_SET &H80040252 No media time format was selected.
VFW_E_MONO_AUDIO_HW &H80040253 Cannot change balance because the audio device is monoaural only.
VFW_E_NO_DECOMPRESSOR &H80040255 Cannot play back the video stream: could not find a suitable decompressor.
VFW_E_NO_AUDIO_HARDWARE &H80040256 Cannot play back the audio stream: no audio hardware is available, or the hardware is not supported.
VFW_E_RPZA &H80040259 Cannot play back the video stream: format 'RPZA' is not supported.
VFW_E_PROCESSOR_NOT_SUITABLE &H8004025B DirectShow cannot play MPEG movies on this processor.
VFW_E_UNSUPPORTED_AUDIO &H8004025C Cannot play back the audio stream: the audio format is not supported.
VFW_E_UNSUPPORTED_VIDEO &H8004025D Cannot play back the video stream: the video format is not supported.
VFW_E_MPEG_NOT_CONSTRAINED &H8004025E DirectShow cannot play this video stream because it falls outside the constrained standard.
VFW_E_NOT_IN_GRAPH &H8004025F Cannot perform the requested function on an object that is not in the filter graph.
VFW_E_NO_TIME_FORMAT &H80040261 Cannot access the time format on an object.
VFW_E_READ_ONLY &H80040262 Could not make the connection because the stream is read-only and the filter alters the data.
VFW_E_BUFFER_UNDERFLOW &H80040264 The buffer is not full enough.
VFW_E_UNSUPPORTED_STREAM &H80040265 Cannot play back the file: the format is not supported.
VFW_E_NO_TRANSPORT &H80040266 Pins cannot connect because they don't support the same transport.
VFW_E_BAD_VIDEOCD &H80040269 The Video CD cannot be read correctly by the device or the data is corrupt.
VFW_S_NO_STOP_TIME &H80040270 The sample had a start time but no stop time. In such a case, the stop time that is returned is set to the start time plus one.
VFW_E_OUT_OF_VIDEO_MEMORY &H80040271 There is not enough video memory at this display resolution and number of colors. Reducing resolution might help.
VFW_E_VP_NEGOTIATION_FAILED &H80040272 The video port connection negotiation process has failed.
VFW_E_DDRAW_CAPS_NOT_SUITABLE &H80040273 Either Microsoft DirectDraw has not been installed or the video card capabilities are not suitable. Make sure the display is not in 16-color mode.
VFW_E_NO_VP_HARDWARE &H80040274 No video port hardware is available, or the hardware is not responding.
VFW_E_NO_CAPTURE_HARDWARE &H80040275 No capture hardware is available, or the hardware is not responding.
VFW_E_DVD_OPERATION_INHIBITED &H80040276 This user operation is inhibited by DVD content at this time.
VFW_E_DVD_INVALIDDOMAIN &H80040277 This operation is not permitted in the current domain.
VFW_E_DVD_NO_BUTTON &H80040278 Requested button is not available.
VFW_E_DVD_GRAPHNOTREADY &H80040279 DVD-Video playback graph has not been built yet.
VFW_E_DVD_RENDERFAIL &H8004027A DVD-Video playback graph building failed.
VFW_E_DVD_DECNOTENOUGH &H8004027B DVD-Video playback graph could not be built due to insufficient decoders.
VFW_E_DVD_NOT_IN_KARAOKE_MODE &H8004028B The DVD Navigator is not in karaoke mode.
VFW_E_FRAME_STEP_UNSUPPORTED &H8004028E Frame stepping is not supported.
VFW_E_PIN_ALREADY_BLOCKED_ON_THIS_THREAD &H80040293 Pin is already blocked on the calling thread.
VFW_E_PIN_ALREADY_BLOCKED &H80040294 Pin is already blocked on another thread.
VFW_E_CERTIFICATION_FAILURE &H80040295 Use of this filter is restricted by a software key. The application must unlock the filter.
VFW_E_BAD_KEY &H800403F2 A registry entry is corrupt.
WS_E_ENDPOINT_ACCESS_DENIED &H803D0005 The remote endpoint indicates that access was denied. This error will only be returned if the remote endpoint indicated this failure.
NS_E_INVALID_PUSH_PUBLISHING_POINT &HC00D151B The publishing point is invalid: it exists or might have an invalid filename.
NS_E_PUSH_CANNOTCONNECT &HC00D2F0B The server rejected connection in push mode.
NS_E_INCOMPATIBLE_PUSH_SERVER &HC00D2F0C Check the port number on which the HTTP Server control protocol is listening for data. The Server service that received the HTTP push request is not a compatible version of WMS. This error may indicate the push request was received by IIS instead of WMS. Ensure WMS is started and has the HTTP Server control protocol properly enabled and try again.
NS_E_CONNECTION_FAILURE &HC00D0029 The connection to the server has failed.
NS_E_DRM_DEBUGGING_NOT_ALLOWED &HC00D2767 The file is protected by DRM. Running this process under a debugger while using DRM content is not allowed.
NS_E_LICENSE_REQUIRED &HC00D0BBE The file is protected by DRM. You need a license to perform the requested operation on this media file.
Help Version 23.0.2024.2.29
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Multimedia C API Help

Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.