The LEADTOOLS Multimedia Toolkit returns error and success notifications (return codes) 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.
Microsoft Visual Basic® programmers will see only the decimal equivalent of the error code's first 16-bit portion. This value appears in an error notification dialog box or in the Err object as a run-time error. If the error is not in the following list, you must convert the decimal number to its hexadecimal equivalent, and then look for the error as described previously. Note that the error's hexadecimal version will be a maximum of four digits long; to find the error, match the last four digits of the hexadecimal code in the error code list to the converted run-time error.
The LEADTOOLS Multimedia filters will return E_EVAL_EXPIRED (0x80050010) if you attempt to create them after the evaluation period has expired.
Typical API HRESULT Values
The following list presents some of the typical COM error and success codes that the LEADTOOLS Multimedia Toolkit returns:
Value |
Number |
Meaning |
NOERROR |
0 |
No error. Numerically equivalent to S_OK. |
S_OK |
0 |
Success. Numerically equivalent to NOERROR. |
S_FALSE |
1 |
Success. Condition was FALSE. |
E_OUTOFMEMORY |
&H80000002 |
Insufficient memory. |
E_INVALIDARG |
&H80000003 |
Argument is invalid. |
E_NOTIMPL |
&H80004001 |
Method is not supported. |
E_POINTER |
&H80004003 |
NULL pointer argument. |
E_FAIL |
&H80004005 |
Failure. |
E_UNEXPECTED |
&H8000FFFF |
Unexpected error. |
E_SHARING_VIOLATION |
&H80070020 |
The output file is in use. |
E_EVAL_EXPIRED |
&H80050010 |
The evaluation period for the filter has expired. |
LTMM_E_INVALID_DATA |
&H80050013 |
Invalid data |
LTMM_E_INVALID_HEADER |
&H80050014 |
Invalid packed data |
LTMM_E_DISABLED |
&H80050015 |
This feature is disabled |
LTMM_E_INVALID_VERSION |
&H80050016 |
This version is not supported |
LTMM_E_STILLIMAGE_LOCKED |
&H80050017 |
The LEADTOOLS still image toolkit needs to be unlocked |
|
|
|
The following are frequently encountered Microsoft/DirectShow error codes. They are included here only for our user's convenience. For a full list of Microsoft/DirectShow error codes, please refer to the Microsoft/DirectShow documentation. |
||
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 The portion of the file holding the video data. The video data might be compressed to save disk space. The data has to be decompressed using a video decompressor before you can play (see) it.: could not find a suitable renderer. |
VFW_S_AUDIO_NOT_RENDERED |
&H00040258 |
Cannot play back the audio stream The portion of the file holding the audio data. The audio data might be compressed to save disk space. The data has to be decompressed using an audio decompressor before you can play (hear) it.: 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 can't 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 audio device is monoaural only. |
VFW_E_NO_DECOMPRESSOR |
&H80040255 |
Cannot play back the video stream: could not find a suitable decompressor Also known as a decoder Also known as a decompressor, this is a module or algorithm to decompress data., this is a module or algorithm to decompress data.. |
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 can't be read correctly by the device or the data is corrupt. |
VFW_S_NO_STOP_TIME |
&H80040270 |
The sample had a start time but not a stop time. In this 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. |
Note: |
The LEADTOOLS Multimedia Toolkit functions will often return error codes native to DirectShow. Please consult the Microsoft DirectX SDK for specific information about DirectShow error codes. |