X-Git-Url: https://notaz.gp2x.de/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=source%2Fmupen64plus-core%2Fdoc%2Femuwiki-api-doc%2FMupen64Plus_v2.0_Core_Basic.txt;fp=source%2Fmupen64plus-core%2Fdoc%2Femuwiki-api-doc%2FMupen64Plus_v2.0_Core_Basic.txt;h=a94ccc35a9fd8c4de64bcdfdb374a103e7d3067e;hb=451ab91e3827a6384981b3300e2a7000d2eaba58;hp=0000000000000000000000000000000000000000;hpb=a2ab25365b5b0dddbee476d695d8a31151407581;p=mupen64plus-pandora.git
diff --git a/source/mupen64plus-core/doc/emuwiki-api-doc/Mupen64Plus_v2.0_Core_Basic.txt b/source/mupen64plus-core/doc/emuwiki-api-doc/Mupen64Plus_v2.0_Core_Basic.txt
new file mode 100644
index 0000000..a94ccc3
--- /dev/null
+++ b/source/mupen64plus-core/doc/emuwiki-api-doc/Mupen64Plus_v2.0_Core_Basic.txt
@@ -0,0 +1,47 @@
+[[Mupen64Plus v2.0 Core API v1.0|Mupen64Plus v2.0 API]]
+
+= Mupen64Plus v2.0 Basic Core API =
+
+Most libmupen64plus functions return an m64p_error return code, which is an enumerated type defined in [[Mupen64Plus v2.0 headers#m64p_types.h|m64p_types.h]]. Front-end code should check the return value of each call to a libmupen64plus function.
+
+{| border="1"
+|Prototype
+|'''m64p_error PluginGetVersion(m64p_plugin_type *PluginType, int *PluginVersion, int *APIVersion, const char **PluginNamePtr, int *Capabilities)'''
+|-
+|Input Parameters
+|'''PluginType''' Pointer to an enumerated type to store the plugin type. The value M64PLUGIN_CORE will always be stored.
+'''PluginVersion''' Pointer to an integer to store the version number of the Mupen64Plus core. Version number 2.1.3 would be stored as 0x00020103.
+'''APIVersion''' Pointer to an integer to store the version number of the Core--Front-end API used by the Mupen64plus core library.
+'''PluginNamePtr''' Pointer to a const character pointer to receive the name of the core library. The const char * which is returned must point to a persistent string (ie, not stored on the stack).
+'''Capabilities''' Pointer to an integer to store a logically-or'd set of flags which specify the capabilities of the core which were built into the library during compilation. These are defined in the m64p_core_caps enumerated type, defined in [[Mupen64Plus v2.0 headers#m64p_types.h|m64p_types.h]].
+|-
+|Usage
+|This function retrieves version information from the core library. This function is the same for the core library and the plugins, so that a front-end may examine all shared libraries in a directory and determine their types. Any of the input parameters may be set to NULL and this function will succeed but won't return the corresponding information.
+|}
+
+{| border="1"
+|Prototype
+|'''m64p_error CoreGetAPIVersions(int *ConfigVersion, int *DebugVersion, int *VidextVersion, int *ExtraVersion)'''
+|-
+|Input Parameters
+|'''ConfigVersion''' Pointer to an integer to store the version number of the Config API exported by the Mupen64plus core library.
+'''DebugVersion''' Pointer to an integer to store the version number of the Debug API exported by the Mupen64plus core library.
+'''VidextVersion''' Pointer to an integer to store the version number of the Video Extension API exported by the Mupen64plus core library.
+'''ExtraVersion''' Pointer to an integer to store an API version number for future use. Currently set to 0.
+|-
+|Usage
+|This function retrieves API version information from the core library. This function may be used by either the front-end application or any plugin modules. Any of the input parameters may be set to NULL and this function will succeed but won't return the corresponding information.
+|}
+
+{| border="1"
+|Prototype
+|'''const char * CoreErrorMessage(m64p_error ReturnCode)'''
+|-
+|Input Parameters
+|'''ReturnCode''' Enumerated type containing an error code.
+|-
+|Usage
+|This function returns a pointer to a NULL-terminated string giving a human-readable description of the error.
+|}
+
+