Function Osiris_LoadMissionModule

Descent3/OsirisLoadandBind.cpp:1322–1407

Osiris_LoadMissionModule Purpose: It will attempt to load the module as a game module. If it succeeds it will return the id of the module where it has been loaded. If the module was already loaded before calling this function, it will return the id to where the module is, and will not reload the module. Returns -1 if the module does not exist. Returns -2 if the module couldn't initialize. Retu

//	This technically doesn't load a mission module, as it should already be loaded by
//	Descent 3 prior.
int Osiris_LoadMissionModule(module *module_handle, const char *filename) {
  if ((Game_mode & GM_MULTI) && (Netgame.local_role != LR_SERVER)) {
    // no scripts for a client!
    return -1;
  }

  if (!module_handle) {
    return -1;
  }

  int loaded_id;

  // find an available slot.
  for (loaded_id = 0; loaded_id < MAX_LOADED_MODULES; loaded_id++) {
    if (!(OSIRIS_loaded_modules[loaded_id].flags & OSIMF_INUSE)) {
      // we found a free slot
      break;
    }
  }

  if (loaded_id >= MAX_LOADED_MODULES) {
    // no slots available
    mprintf(0, "OSIRIS: Osiris_LoadMissionModule(%s): No available slots\n", filename);
    Int3();
    return -4;
  }

  // make sure the module exists so we can load it
  if (!module_handle->handle) {
    // the module does not exist
    mprintf(0, "OSIRIS: Osiris_LoadMissionModule(%s): Module doesn't exist\n", filename);
    // Int3();
    return -1;
  }

  // the module has loaded, attempt to import all the game functions
  tOSIRISModule *osm = &OSIRIS_loaded_modules[loaded_id];
  memcpy(&osm->mod, module_handle, sizeof(module));
  module *mod = &osm->mod;

  // there are 5 functions we need to import
  // GetGOScriptID@4
  // CreateInstance@4
  // DestroyInstance@8
  // CallInstanceEvent@16
  // SaveRestoreState@8

  osm->InitializeDLL = NULL;
  osm->ShutdownDLL = NULL;
  osm->GetTriggerScriptID = NULL;
  osm->GetCOScriptList = NULL;
  osm->GetGOScriptID = (GetGOScriptID_fp)mod_GetSymbol(mod, "GetGOScriptID", 8);
  osm->CreateInstance = (CreateInstance_fp)mod_GetSymbol(mod, "CreateInstance", 4);
  osm->DestroyInstance = (DestroyInstance_fp)mod_GetSymbol(mod, "DestroyInstance", 8);
  osm->CallInstanceEvent = (CallInstanceEvent_fp)mod_GetSymbol(mod, "CallInstanceEvent", 16);
  osm->SaveRestoreState = (SaveRestoreState_fp)mod_GetSymbol(mod, "SaveRestoreState", 8);

  osm->flags = OSIMF_INUSE | OSIMF_DLLELSEWHERE;