Predefined #defines have changed.

[cc65] / include / em.h

diff --git a/include/em.h b/include/em.h
index a69c9598dd2502c18e9573abb94a4e7120519c62..38eb24bb705539a9d1caa9440800a6057903cf86 100644 (file)
--- a/include/em.h
+++ b/include/em.h
@@ -6,10 +6,10 @@
 /*                                                                           */
 /*                                                                           */
 /*                                                                           */
-/* (C) 2002      Ullrich von Bassewitz                                       */
-/*               Wacholderweg 14                                             */
-/*               D-70597 Stuttgart                                           */
-/* EMail:        uz@musoftware.de                                            */
+/* (C) 2002-2003 Ullrich von Bassewitz                                       */
+/*               Römerstrasse 52                                             */
+/*               D-70794 Filderstadt                                         */
+/* EMail:        uz@cc65.org                                                 */
 /*                                                                           */
 /*                                                                           */
 /* This software is provided 'as-is', without any expressed or implied       */
@@ -76,10 +76,18 @@ struct em_copy {
 
 
 unsigned char __fastcall__ em_load_driver (const char* driver);
-/* Load an extended memory driver and return an error code */
+/* Load and install an extended memory driver. Return an error code. */
 
 unsigned char __fastcall__ em_unload (void);
-/* Unload the currently loaded driver. */
+/* Uninstall, then unload the currently loaded driver. */
+
+unsigned char __fastcall__ em_install (void* driver);
+/* Install an already loaded driver. Return an error code. */
+
+unsigned char __fastcall__ em_uninstall (void);
+/* Uninstall the currently loaded driver and return an error code.
+ * Note: This call does not free allocated memory.
+ */
 
 unsigned __fastcall__ em_pagecount (void);
 /* Return the total number of 256 byte pages available in extended memory. */
@@ -90,6 +98,15 @@ void* __fastcall__ em_map (unsigned page);
  * em_commit, the old contents of the memory window may be lost!
  */
 
+void* __fastcall__ em_use (unsigned page);
+/* Tell the driver that the memory window is associated with a given page.
+ * This call is very similar to em_map. The difference is that the driver
+ * does not necessarily transfer the current contents of the extended
+ * memory into the returned window. If you're going to just write to the
+ * window and the current contents of the window are invalid or no longer
+ * use, this call may perform better than em_map.
+ */
+
 void __fastcall__ em_commit (void);
 /* Commit changes in the memory window to extended storage. If the contents
  * of the memory window have been changed, these changes may be lost if
@@ -110,7 +127,7 @@ void __fastcall__ em_copyto (const struct em_copy* copy_data);
 
 
 
-/* End of em.h */
+/* End of em.h */               
 #endif