win12.hlp (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
WinGetScreenPS (1.2)
Function Group  Overview                          Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_WINWINDOWMGR
 
HPS WinGetScreenPS(hwndDesktop)
HWND hwndDesktop;    /* handle of the desktop */
 
The WinGetScreenPS function returns a cached presentation space that can be
used for drawing anywhere on the screen.
 
Parameter    Description
────────────────────────────────────────────────────────────────────────────
 
hwndDesktop  Identifies the desktop window. This parameter can be
             HWND_DESKTOP or the desktop window handle.
 
Return Value
 
The return value is a presentation space, or NULL if an error occurs.
 
Comments
 
When your application finishes using the presentation space, the space
should be released by calling the WinReleasePS function.
 
The WinLockWindowUpdate function should be used to avoid updating the same
part of the screen at the same time.
 
See Also
 
WinGetPS, WinLockWindowUpdate, WinReleasePS
 
                                      ♦