API

#include <VirtualC64.h>

class API

Defined in VirtualC64.h:92

Base class of all APIs

Provides the suspend / resume mechanism that every API class inherits.

Public Methods

Return	Name	Description
void	suspend const	Suspends the emulator thread.
void	resume const	Resumes the emulator thread after a call to suspend().

---

suspend

const

void suspend() const

Defined in VirtualC64.h:121

Suspends the emulator thread.

Blocks until the emulator thread has stopped at a safe point, i.e., it is neither computing a frame nor processing its command queue. The call can be nested: the thread continues once resume() has been called as often as suspend(). Use it to read or modify the state of a component that is not protected by the API itself.

Only one thread can hold a suspension at a time. Another thread that calls suspend(), or a blocking API function that waits for the emulator thread, waits until the holder has resumed the emulator. The holder itself must not call such a function, because it would wait for itself: they throw a CoreError, and so does halt(). Do not call suspend() from the emulator thread.

---

resume

const

void resume() const

Defined in VirtualC64.h:125

Resumes the emulator thread after a call to suspend().