File - Call DLL Function

This action will run a function from a dynamically linked library (DLL). It can be used to extend AutoPlay's functionality with your own functions.

 IMPORTANT 

 

 

 

!

Caution: Calling DLLs is a fairly advanced thing to do and writing DLLs is best done with C or C++. We have tried to provide a large range of functionality with AutoPlay, so there aren't many reasons to use external DLL calls. Make sure that you know exactly what parameters the DLL function you are calling takes. Providing too many or not enough parameters can corrupt the running AutoPlay application's memory so please do so at your own risk.

Action ID:
Action Category:
Action List Syntax:

143
File
<<VARIABLE>>
= File.CallDLLFunction (<<FILENAME>>, <<FUNCTIONNAME>>, <<PARAMETERLIST>>)

Settings

DLL Information

DLL file name:

The full path and filename of the DLL file that you want to call.

Function name:

The name of the function that you want to call in the DLL.

Function parameters:

The comma-separated list of parameters that you want to pass to the function in the DLL.

Place double-quotes around any parameters that you want passed as NULL-terminated string pointers. Parameters without quotes will be passed as LONG integers.

All parameters are one-way only—they can be passed into the DLL function, but they cannot be evaluated after the function has been called. (In other words, these parameters are pass-by-value, not pass-by-reference.)

Return value type:

The return value type of the function. Choose from Int, Long or String. This field tells AutoPlay Media Studio how to interpret the value returned from the function. If the function that you're calling does not return a value (i.e., the function returns void), use Long as the return value type.

Calling convention:

The calling convention that AutoPlay will use when calling the DLL function. Choose between: "__cdecl" and " __stdcall"

Variable

Store return value in variable:

The name of the variable that the value returned from the DLL function will be stored in.

Error Codes

Value
(%LastErrorNum%)

Simple Message
(%LastErrorMsg%)

Verbose Message
(%LastErrorDetails%)

0 (OK)

 

 

1

MSG_ERR_FILE_CALL_DLL_FUNCTION

MSG_ERR_FILE_CALL_DLL_FUNCTION
MSG_ERR_LOAD_DLL_FAILED
<<FILENAME>>

2

MSG_ERR_FILE_CALL_DLL_FUNCTION

MSG_ERR_FILE_CALL_DLL_FUNCTION
MSG_ERR_FAILED_DLL_FIND_FUNCTION
<<FILENAME>>

<<FUNCTIONNAME>>

Examples

None