Command Reference - File Actions
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: |
143 |
DLL Information
The full path and filename of the DLL file that you want to call.
The name of the function that you want to call in the DLL.
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.)
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.
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.
|
Value |
Simple Message |
Verbose Message |
|
0 (OK) |
|
|
|
1 |
MSG_ERR_FILE_CALL_DLL_FUNCTION |
MSG_ERR_FILE_CALL_DLL_FUNCTION |
|
2 |
MSG_ERR_FILE_CALL_DLL_FUNCTION |
MSG_ERR_FILE_CALL_DLL_FUNCTION |
None