GreDeath: Difference between revisions
Created page with "GreDeath informs the presentation driver that the entire screen is required by another screen group (an application that is not running under the Presentation Manager interfac..." |
mNo edit summary |
||
| Line 1: | Line 1: | ||
GreDeath informs the presentation driver that the entire screen is required by another screen group (an application that is not running under the Presentation Manager interface). | GreDeath informs the presentation driver that the entire screen is required by another screen group (an application that is not running under the Presentation Manager interface). | ||
;Simulation support: This function is mandatory for display drivers. For other drivers, it is simulated by a handling routine in the graphics engine. | ;Simulation support: This function is mandatory for display drivers. For other drivers, it is simulated by a handling routine in the graphics engine. | ||
== Syntax == | == Syntax == | ||
GreDeath(hdc, pInstance, lFunction) | GreDeath(hdc, pInstance, lFunction) | ||
== Parameters == | == Parameters == | ||
;hdc (HDC) - input | ;hdc (HDC) - input:The device context handle. | ||
:The device context handle. | ;pInstance (PVOID) - input:A pointer to instance data. | ||
;lFunction (ULONG) - input:High-order WORD=flags; low-order WORD=NGreDeath. | |||
;pInstance (PVOID) - input | |||
:A pointer to instance data. | |||
;lFunction (ULONG) - input | |||
:High-order WORD=flags; low-order WORD=NGreDeath. | |||
== Returns == | == Returns == | ||
;fSuccess (BOOL) - returns | ;fSuccess (BOOL) - returns:Return codes. | ||
:Return codes. | :On completion, the handling routine must return BOOLEAN (fSuccess). | ||
:*TRUE Successful | |||
:On completion, the handling routine must return BOOLEAN (fSuccess). | :*FALSE Error. | ||
:Possible Errors Detected: When an error is detected, the handling routine must call WinSetErrorInfo to post the condition. An error code for conditions that the handling routine is expected to check: | |||
:*TRUE Successful | :*PMERR_DEV_FUNC_NOT_INSTALLED. | ||
:*FALSE Error. | |||
:Possible Errors Detected: When an error is detected, the handling routine must call WinSetErrorInfo to post the condition. An error code for conditions that the handling routine is expected to check: | |||
:*PMERR_DEV_FUNC_NOT_INSTALLED. | |||
== Remarks == | == Remarks == | ||
Any current Presentation Manager applications are set to the background. While this condition exists, the presentation driver must make all calls as usual. However, it might not affect the underlying hardware, that is, the presentation driver must continue to accumulate bounds and respond to queries but it might not actually draw to the display. When GreResurrection is called, the missing output will be re-created by the system sending a WM_PAINT message to the application. | Any current Presentation Manager applications are set to the background. While this condition exists, the presentation driver must make all calls as usual. However, it might not affect the underlying hardware, that is, the presentation driver must continue to accumulate bounds and respond to queries but it might not actually draw to the display. When [[GreResurrection]] is called, the missing output will be re-created by the system sending a WM_PAINT message to the application. | ||
This function goes directly to the Presentation Manager interface. | This function goes directly to the Presentation Manager interface. | ||
[[Category:Gre]] | [[Category:Gre]] | ||
Latest revision as of 07:53, 5 March 2020
GreDeath informs the presentation driver that the entire screen is required by another screen group (an application that is not running under the Presentation Manager interface).
- Simulation support
- This function is mandatory for display drivers. For other drivers, it is simulated by a handling routine in the graphics engine.
Syntax
GreDeath(hdc, pInstance, lFunction)
Parameters
- hdc (HDC) - input
- The device context handle.
- pInstance (PVOID) - input
- A pointer to instance data.
- lFunction (ULONG) - input
- High-order WORD=flags; low-order WORD=NGreDeath.
Returns
- fSuccess (BOOL) - returns
- Return codes.
- On completion, the handling routine must return BOOLEAN (fSuccess).
- TRUE Successful
- FALSE Error.
- Possible Errors Detected: When an error is detected, the handling routine must call WinSetErrorInfo to post the condition. An error code for conditions that the handling routine is expected to check:
- PMERR_DEV_FUNC_NOT_INSTALLED.
Remarks
Any current Presentation Manager applications are set to the background. While this condition exists, the presentation driver must make all calls as usual. However, it might not affect the underlying hardware, that is, the presentation driver must continue to accumulate bounds and respond to queries but it might not actually draw to the display. When GreResurrection is called, the missing output will be re-created by the system sending a WM_PAINT message to the application.
This function goes directly to the Presentation Manager interface.