New ErrorCodes

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.