hdc (HDC) - input

Device context handle.

lType (ULONG) - input

Resource type.

Resource types returned by the presentation driver:

RT_DISPLAYINFO

A structure containing some of the display constants required by the Window Manager. This information is required for all display devices that support windows. The format of the DISPLAYINFO structure is:

cb

Size of this structure (always set to 26).
cxIcon
Count of pels for x-width of icon.
cyIcon
Count of pels for y-height of icon. When WinLoadPointer is used to load the icon, it is stretched or compressed to the size indicated by cxIcon and cyIcon.
cxPointer
Count of pels for x-width of pointer.
cyPointer
Count of pels for y-height of pointer. When WinLoadPointer is used to load the pointer, it is stretched or compressed to the size indicated by cxPointer and cyPointer.
cxBorder
Count of pels for X-width of horizontal border.
cyBorder
Count of pels for Y-height vertical border.
cxHSlider
Count of pels for X-width of horizontal scroll bar slider.
cyVSlider
Count of pels for Y-height of vertical scroll bar slider.
cxSizeBorder
Count of pels for X-width of default border.
cySizeBorder
Count of pels for Y-height of default border.
cxDeviceAlign
Count of pels for horizontal device alignment.
cyDeviceAlign
Count of pels for vertical device alignment. Some display devices operate faster when operation coordinates are aligned to a BYTE, WORD or DWORD boundary.

The cxDeviceAlign and cyDeviceAlign parameters allow the presentation driver to align windows on these boundaries and so optimize window management operations.

RT_POINTER
Defined system pointers are:

SPTR_ARROW

Left-pointing arrow, usually the system default.
SPTR_TEXT
Text-insertion pointer, typically used when the mouse pointer is on an edit control.
SPTR_WAIT
An hourglass used to tell the user to wait while the system is busy.
SPTR_MOVE
Four arrows together, pointing north, south, east and west, that tell the user that window can be dragged in any of these directions.
SPTR_SIZENWSE
An arrow pointing northwest and southeast, that tells the user that the window can be sized in these directions.
SPTR_SIZENESW
An arrow pointing northeast and southwest, that tells the user that the window can be sized in these directions.
SPTR_SIZEWE
An arrow pointing east and west, that tells the user that the window can be sized in these directions.
SPTR_SIZENS
An arrow pointing north and south, that tells the user that the window can be sized in these directions.
SPTR_APPICON
Usually a blank icon. This is used when a window that has been sized down to its minimum (and has no normal icon) is dragged across the screen.
SPTR_ICONINFORMATION
Pointer used as part of a message box when specified in a call to WinMessageBox.
SPTR_ICONQUESTION
Pointer used as part of a message box when specified in a call to WinMessageBox.
SPTR_ICONERROR
Pointer used as part of a message box when specified in a call to WinMessageBox.
SPTR_ICONWARNING
Pointer used as part of a message box when specified in a call to WinMessageBox.
SPTR_ILLEGAL
Pointer used by the filing system to notify the user of an illegal mouse-directed copy or move operation.
SPTR_MULTFILE
Pointer used by the file system to indicate a multiple file copy or move operation.
SPTR_PROGRAM
Pointer used by the file system to indicate a copy or move operation on an executable program file.
SPTR_FILE
Pointer used by the file system to indicate a copy or move operation on an ordinary file.
SPTR_FOLDER
Pointer used by the file system to indicate a copy or move operation on an entire directory.
RT_BITMAP
The following defined system bit maps are required in display drivers:

SBMP_BTNCORNERS

Contains the rounded corners for push buttons. It is arranged as three bit maps divided into 2x2 bit-map arrays describing the corners of each bit map. The three bit maps are defined as follows:

• Contains the corners of an unselected push button that is not a default push button.

• Holds the corners of a default push button that is currently not selected.

• Contains the corners of a currently selected push button, which can be either a default or nondefault push button.
SBMP_DRIVE
Used by the file system to display the logical disk drive.
SBMP_FILE
Used by the file system to indicate an unknown file type.
SBMP_FOLDER
Used by the file system to display a directory.
SBMP_MENUATTACHED
Drawn on the right edge of a menu item to indicate that a pull down menu is attached to that item.
SBMP_MENUCHECK
Displayed next to a menu item when the item is checked. Menu items are displayed in the system font and the menu checks are vertically aligned next to them. The height of this bit map must be no greater than the system font height to ensure that consecutive menu-check bit maps do not overlap. Its width is arbitrary, but is normally the same as the system font width.
SBMP_PROGRAM
Used by the file system to mark EXE and COM files.
SBMP_SIZEBOX
Used by some applications to display a "sizebox" in the bottom-right corner of a frame window.
SBMP_TREEMINUS
Used by the file system to indicate there are no more subdirectories to view.
SBMP_TREEPLUS
Used by the file system to indicate there are more subdirectories to view.
The following defined system bit maps are also required to ensure compatibility with OS/2 Version 1.x applications:

SBMP_OLD_CHILDSYSMENU

SBMP_OLD_CHECKBOXES
SBMP_OLD_MAXBUTTON
SBMP_OLD_MINBUTTON
SBMP_OLD_RESTOREBUTTON
SBMP_OLD_SBDNARROW
SBMP_OLD_SBLFARROW
SBMP_OLD_SBRGARROW
SBMP_OLD_SBUPARROW
SBMP_OLD_SYSMENU.
The following defined system bit maps are provided by PMWIN.DLL and are optional in display drivers:

SBMP_CHECKBOXES

SBMP_CHILDSYSMENU
SBMP_CHILDSYSMENUDEP
SBMP_CLOSEBUTTON
SBMP_CLOSEBUTTONDEP
SBMP_COMBODOWN
SBMP_MAXBUTTON
SBMP_MAXBUTTONDEP
SBMP_MINBUTTON
SBMP_MINBUTTONDEP
SBMP_RESTOREBUTTON
SBMP_RESTOREBUTTONDEP
SBMP_SBDNARROW
SBMP_SBDNARROWDEP
SBMP_SBDNARROWDIS
SBMP_SBLFARROW
SBMP_SBLFARROWDEP
SBMP_SBLFARROWDIS
SBMP_SBRGARROWDEP
SBMP_SBRGARROWDIS
SBMP_SBRGARRROW
SBMP_SBUPARROW
SBMP_SBUPARROWDEP
SBMP_SBUPARROWDIS
SBMP_SYSMENU
SBMP_SYSMENUDEP
Refer to the function "WinGetSysBitmap" in Presentation Manager Programming Reference for further explanation.
RT_FONT
The default system fonts are:

SFONT_RASTER

Default image font.
SFONT_OUTLINE
Default outline font.

id (ULONG) - input

Defined resource value.

pInstance (PVOID) - input

Pointer to instance data.

lFunction (ULONG) - input

High-order WORD=flags; low-order WORD=NGreQueryDevResource.

rc (LONG) - returns

Return Code.

This function returns the address of the indicated resource-0 if no address is available, or GPI_ALTERROR if an error occurs.

Possible Errors Detected: When an error is detected, the handling routine must call WinSetErrorInfo to post the condition. Error codes for conditions that the handling routine is expected to check include:

PMERR_BASE_ERROR PMERR_DEV_FUNC_NOT_INSTALLED

Refer to the "Error Explanations" section of the Presentation Manager Programming Reference for further explanation.

---

[Back: GreQueryDevResource Return Value - rc]
[Next: GreQueryDevResource - Remarks]