GreCloseDC: Difference between revisions
Created page with "GreCloseDC closes a device context. This function is supported by the graphics engine. ==Syntax== GreCloseDC(hdc, pInstance, lFunction); ==Parameters== ;hdc (HDC) - input ..." |
mNo edit summary |
||
| Line 1: | Line 1: | ||
GreCloseDC closes a device context. | GreCloseDC closes a device context. | ||
This function is supported by the graphics engine. | |||
==Syntax== | ==Syntax== | ||
GreCloseDC(hdc, pInstance, lFunction) | GreCloseDC(hdc, pInstance, lFunction) | ||
==Parameters== | ==Parameters== | ||
;hdc (HDC) - input | ;hdc (HDC) - input:Device context handle. | ||
:Device context handle. | ;pInstance (PVOID) - input:Pointer to instance data. | ||
;lFunction (ULONG) - input:High-order WORD=flags; low-order WORD=NGreCloseDC. | |||
;pInstance (PVOID) - input | |||
:Pointer to instance data. | |||
;lFunction (ULONG) - input | |||
:High-order WORD=flags; low-order WORD=NGreCloseDC. | |||
==Return Code== | ==Return Code== | ||
;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 graphics engine calls WinSetErrorInfo to post the condition. Error codes for conditions that the handling routine is expected to check include: | |||
*TRUE Successful | *PMERR_BASE_ERROR | ||
*FALSE Error | *PMERR_BITMAP_IS_SELECTED | ||
*PMERR_DEV_FUNC_NOT_INSTALLED | |||
Possible Errors Detected: | *PMERR_EXCEEDS_MAX_SEG_LENGTH | ||
*PMERR_HBITMAP_BUSY | |||
*PMERR_BASE_ERROR | *PMERR_HDC_BUSY | ||
*PMERR_BITMAP_IS_SELECTED | *PMERR_INSUFFICIENT_MEMORY | ||
*PMERR_DEV_FUNC_NOT_INSTALLED | *PMERR_INV_BITMAP_DIMENSION | ||
*PMERR_EXCEEDS_MAX_SEG_LENGTH | *PMERR_INV_CODEPAGE | ||
*PMERR_HBITMAP_BUSY | *PMERR_INV_COORDINATE | ||
*PMERR_HDC_BUSY | *PMERR_INV_DC_TYPE | ||
*PMERR_INSUFFICIENT_MEMORY | *PMERR_INV_HBITMAP | ||
*PMERR_INV_BITMAP_DIMENSION | *PMERR_INV_HDC | ||
*PMERR_INV_CODEPAGE | *PMERR_INV_HRGN | ||
*PMERR_INV_COORDINATE | *PMERR_INV_ID | ||
*PMERR_INV_DC_TYPE | *PMERR_INV_IN_AREA | ||
*PMERR_INV_HBITMAP | *PMERR_INV_IN_PATH | ||
*PMERR_INV_HDC | *PMERR_INV_INFO_TABLE | ||
*PMERR_INV_HRGN | *PMERR_INV_LENGTH_OR_COUNT | ||
*PMERR_INV_ID | *PMERR_INV_RECT | ||
*PMERR_INV_IN_AREA | *PMERR_INV_REGION_CONTROL | ||
*PMERR_INV_IN_PATH | *PMERR_INV_SCAN_START | ||
*PMERR_INV_INFO_TABLE | Refer to the "Error Explanations" section of the ''Presentation Manager Programming Reference'' for further explanation. | ||
*PMERR_INV_LENGTH_OR_COUNT | |||
*PMERR_INV_RECT | |||
*PMERR_INV_REGION_CONTROL | |||
*PMERR_INV_SCAN_START | |||
Refer to the "Error Explanations" section of the Presentation Manager Programming Reference for further explanation. | |||
==Remarks== | ==Remarks== | ||
If the device context is a memory DC that has a bit map selected, the engine deselects the bit map before destroying the DC. This function deletes any visible regions and clip regions selected into the DC. | If the device context is a memory DC that has a bit map selected, the engine deselects the bit map before destroying the DC. This function deletes any visible regions and clip regions selected into the DC. | ||
[[Category:Gre]] | [[Category:Gre]] | ||
Latest revision as of 12:44, 5 March 2020
GreCloseDC closes a device context.
This function is supported by the graphics engine.
Syntax
GreCloseDC(hdc, pInstance, lFunction)
Parameters
- hdc (HDC) - input
- Device context handle.
- pInstance (PVOID) - input
- Pointer to instance data.
- lFunction (ULONG) - input
- High-order WORD=flags; low-order WORD=NGreCloseDC.
Return Code
- 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 graphics engine calls WinSetErrorInfo to post the condition. Error codes for conditions that the handling routine is expected to check include:
- PMERR_BASE_ERROR
- PMERR_BITMAP_IS_SELECTED
- PMERR_DEV_FUNC_NOT_INSTALLED
- PMERR_EXCEEDS_MAX_SEG_LENGTH
- PMERR_HBITMAP_BUSY
- PMERR_HDC_BUSY
- PMERR_INSUFFICIENT_MEMORY
- PMERR_INV_BITMAP_DIMENSION
- PMERR_INV_CODEPAGE
- PMERR_INV_COORDINATE
- PMERR_INV_DC_TYPE
- PMERR_INV_HBITMAP
- PMERR_INV_HDC
- PMERR_INV_HRGN
- PMERR_INV_ID
- PMERR_INV_IN_AREA
- PMERR_INV_IN_PATH
- PMERR_INV_INFO_TABLE
- PMERR_INV_LENGTH_OR_COUNT
- PMERR_INV_RECT
- PMERR_INV_REGION_CONTROL
- PMERR_INV_SCAN_START
Refer to the "Error Explanations" section of the Presentation Manager Programming Reference for further explanation.
Remarks
If the device context is a memory DC that has a bit map selected, the engine deselects the bit map before destroying the DC. This function deletes any visible regions and clip regions selected into the DC.