7bca5fab5b
git-svn-id: svn://svn.compuextreme.de/Viitor/V962/Viitor_cc65@4352 504e572c-2e33-0410-9681-be2bf7408885
61 lines
2.2 KiB
HTML
61 lines
2.2 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
|
<HTML>
|
|
<HEAD>
|
|
<META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.20">
|
|
<TITLE>cc65 function reference: Alphabetical function reference: em_map</TITLE>
|
|
<LINK HREF="funcref-98.html" REL=next>
|
|
<LINK HREF="funcref-96.html" REL=previous>
|
|
<LINK HREF="funcref.html#toc3" REL=contents>
|
|
</HEAD>
|
|
<BODY>
|
|
<A HREF="funcref-98.html">Next</A>
|
|
<A HREF="funcref-96.html">Previous</A>
|
|
<A HREF="funcref.html#toc3">Contents</A>
|
|
<HR>
|
|
<H2><A NAME="em_map"></A> 3.52 <A HREF="funcref.html#toc3.52">em_map</A></H2>
|
|
|
|
|
|
<P>
|
|
<BLOCKQUOTE>
|
|
<DL>
|
|
<DT><B>Function</B><DD><P>Make a page of extended memory accessible.</P>
|
|
<DT><B>Header</B><DD><P><CODE>
|
|
<A HREF="funcref-18.html#em.h">em.h</A></CODE></P>
|
|
<DT><B>Declaration</B><DD><P><CODE>void* __fastcall__ em_map (unsigned page);</CODE></P>
|
|
<DT><B>Description</B><DD><P>The function maps one page of extended memory into linear
|
|
memory and returns a pointer to the page frame. Depending on the hardware
|
|
and driver, the data is either mapped into the address space or transfered
|
|
into a buffer. If you don't need the actual contents of the page (for example
|
|
because you're going to overwrite it completely, it is better to call
|
|
<CODE>
|
|
<A HREF="funcref-101.html#em_use">em_use</A></CODE> instead. <CODE>em_use</CODE> will not transfer the
|
|
data if it is possible to avoid that.</P>
|
|
<DT><B>Limits</B><DD><P>
|
|
<UL>
|
|
<LI>Calling <CODE>em_map</CODE> will invalidate the memory window, so if you
|
|
made any changes to the data in the window, call <CODE>
|
|
<A HREF="funcref-92.html#em_commit">em_commit</A></CODE> first, or the changes are lost.</LI>
|
|
<LI>The function is only available as fastcall function, so it may only be
|
|
used in presence of a prototype.</LI>
|
|
<LI>The function produces undefined results if no extended memory driver is
|
|
loaded.</LI>
|
|
</UL>
|
|
</P>
|
|
<DT><B>Availability</B><DD><P>cc65</P>
|
|
<DT><B>See also</B><DD><P>
|
|
<A HREF="funcref-92.html#em_commit">em_commit</A>,
|
|
<A HREF="funcref-96.html#em_load_driver">em_load_driver</A>,
|
|
<A HREF="funcref-101.html#em_use">em_use</A></P>
|
|
<DT><B>Example</B><DD><P>None.</P>
|
|
</DL>
|
|
</BLOCKQUOTE>
|
|
</P>
|
|
|
|
|
|
<HR>
|
|
<A HREF="funcref-98.html">Next</A>
|
|
<A HREF="funcref-96.html">Previous</A>
|
|
<A HREF="funcref.html#toc3">Contents</A>
|
|
</BODY>
|
|
</HTML>
|