Specifies
whether the DC is a foreground or background window.
Used to indicate if the default colors have changed. The possible values
are:
RP_BACKGROUND=0
When a palette is realized in the
background (that is, the application making the WinRealizePalette call does
not have the focus), then the driver should not change any entries in the
hardware palette that are already mapped by other logical palettes. The
presentation driver must either modify hardware palette entries that are
currently unused, modify the default palette size to make additional slots
available, or locate nearest color matches.
RP_FOREGROUND=1
When a logical palette is realized in the foreground
(that is, the application making the WinRealizePalette call has the focus),
then that palette receives priority over any other palettes that were previously
realized. To satisfy the color requests of the foreground WinRealizePalette,
the driver should overwrite entries in the hardware palette that are allocated
to other applications, if necessary.
RP_DEFAULTSCHANGED=2
Returned by the presentation driver to indicate
that all direct DCs need repainting, due to a change in the number of default
system colors.
pcSlotsChanged (PULONG) - input
Pointer to the returned count of hardware slots
changed.
pInstance (PVOID) - input
Pointer
to instance data.
lFunction (ULONG) - input
High-order
WORD=flags; low-order WORD=NGreRealizePalette.
rc (ULONG) - returns
Return
codes.
On completion, this function returns the following value:
PAL-ERROR Error
Number of logical palette mappings
changed.
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:
[Back: GreRealizePalette Return Value - rc]
[Next: GreRealizePalette - Remarks]