| Home
| Previous
| Next
| Up

PM_doSuspendApp

Suspends the application by switch back to the OS desktop

Declaration

void PMAPI PM_doSuspendApp(void)

Prototype In

pmapi.h

Description

This function suspends the application by switching back to the regular OS desktop, allowing normal application code to be processed and then waiting for the application activate command to bring us back to fullscreen mode.

This version only gets called if we have not captured the screen switch in our activate message loops and will occur if the DirectDraw drivers lose a surface for some reason while rendering. This should not normally happen, but it is included just to be sure (it can happen on WinNT/2000/XP if the user hits the Ctrl-Alt-Del key combination). Note that this code will always spin loop, and we cannot disable the spin looping from this version (ie: if the user hits Ctrl-Alt-Del under WinNT/2000 the application main loop will cease to be executed until the user switches back to the application).

Copyright © 2002 SciTech Software, Inc. Visit our web site at http://www.scitechsoft.com