PFND3DDDI_SETOVERLAYCOLORCONTROLS fonction de rappel (d3dumddi.h)
La fonction SetOverlayColorControls modifie les paramètres de contrôle des couleurs pour la superposition donnée.
Syntaxe
PFND3DDDI_SETOVERLAYCOLORCONTROLS Pfnd3dddiSetoverlaycolorcontrols;
HRESULT Pfnd3dddiSetoverlaycolorcontrols(
HANDLE hDevice,
const D3DDDIARG_SETOVERLAYCOLORCONTROLS *unnamedParam2
)
{...}
Paramètres
hDevice
Handle de l’appareil d’affichage (contexte graphique).
unnamedParam2
pData [in]
Pointeur vers une structure de D3DDDIARG_SETOVERLAYCOLORCONTROLS qui décrit les paramètres de modification des paramètres de contrôle des couleurs d’une superposition.
Valeur retournée
SetOverlayColorControls retourne l’une des valeurs suivantes :
| Code de retour | Description |
|---|---|
| S_OK | Les paramètres de contrôle des couleurs ont été modifiés. |
| E_INVALIDARG | Les paramètres ont été validés et déterminés comme incorrects. |
| E_OUTOFMEMORY | SetOverlayColorControls n’a pas pu allouer la mémoire nécessaire pour qu’il se termine. |
Remarques
Le runtime Microsoft Direct3D appelle la fonction SetOverlayColorControls pour modifier les paramètres de luminosité, de contraste, de teinte, de saturation, de netteté, de gamma et d’activation des couleurs associés à une superposition spécifique.
Le runtime peut également appeler SetOverlayColorControls pour une superposition qui n’est pas encore visible. Dans ce cas, lorsque le membre hOverlay de la structure D3DDDIARG_SETOVERLAYCOLORCONTROLS pointée par pData est défini sur NULL, le pilote doit stocker les paramètres de contrôle de couleur fournis et les utiliser lorsqu’une superposition qui fait référence à la ressource spécifiée est créée.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | d3dumddi.h (inclure D3dumddi.h) |