Why do I receive a "specified module could not be found" error while running a MEX-file in MATLAB?
Show older comments
When I try to run a MEX file in MATLAB, I receive the following error:
ERROR: Invalid MEX-file 'mexfilename': The specified module could not be found.
where "mexfilename" is the name of my MEX-file. However, I did not receive any errors when compiling the file.
Accepted Answer
MathWorks Support Team
on 6 Feb 2025
Edited: MathWorks Support Team
on 14 Feb 2025
This dependency error indicates that MATLAB cannot find all .dll files referenced by the MEX file module "mexfilename".
Determine missing dependencies:
To resolve this error, find the names of your MEX file's dependent libraries, and determine if they are present on your system and on the system path. To find library dependencies on Windows, you can use the third-party utility Dependency Walker: https://www.dependencywalker.com
For Visual Studio users, you can also use the dumpbin utility included with MSVC Build Tools. To do this, open the Developer Command Prompt and enter the command:
dumpbin /DEPENDENTS <your_mex_file_name_here>
See the following article for more details and options on Linux/MacOS:
For .dll files that the MEX file linked against when it was built, the .dll files must be on the system path or in the same folder as the MEX file.
Other possible causes:
MEX files might require additional libraries that are not linked to the MEX file. Failure to find one of these explicitly loaded libraries might not prevent a MEX file from loading, but prevents it from working correctly. The code that loads the libraries controls the search path used to find these libraries. The search path might not include the folder that contains the MEX file. Consult the library documentation on proper installation locations.
Possible reasons for failure include:
- MATLAB version incompatibility. For more information, see MEX Version Compatibility.
- Missing compiler run-time libraries. If your system does not have the same compiler that built the MEX file, see the Microsoft® MSDN® website for information about Visual C++® Redistributable Packages.
- Missing or incorrectly installed specialized run-time libraries. Contact your MEX file or library vendor.
2 Comments
Eric
on 4 Jun 2015
Chad,
Thanks for the info. I also found libmex.dll and libmx.dll in the list reported by dependency walker and these weren't the problem either (for obvious reasons, perhaps).
-Eric
Oliver Woodford
on 20 Jul 2015
It would be much more helpful if the error message said which module was missing.
More Answers (1)
Jim Hokanson
on 18 Jun 2014
3 votes
In my case I needed to install a Visual Studio redistributable Package that matched the version used when compiling the libraries I was linking against. A Google search "Visual Studio redistributable 2012" provided the link to the installer I needed. Once this was installed I could compile directly from Matlab. I am guessing that if I had compiled from inside visual studio instead of from within Matlab things would have worked as well.
Categories
Find more on Introduction to Installation and Licensing in Help Center and File Exchange
on 13 Jun 2013
on 14 Feb 2025
Community Treasure Hunt
Find the treasures in MATLAB Central and discover how the community can help you!
Start Hunting!
