PFND3DDDI_GETOVERLAYCOLORCONTROLS fonction de rappel (d3dumddi.h)
La fonction GetOverlayColorControls récupère les paramètres de contrôle des couleurs pour la superposition donnée.
Syntaxe
PFND3DDDI_GETOVERLAYCOLORCONTROLS Pfnd3dddiGetoverlaycolorcontrols;
HRESULT Pfnd3dddiGetoverlaycolorcontrols(
HANDLE hDevice,
D3DDDIARG_GETOVERLAYCOLORCONTROLS *unnamedParam2
)
{...}
Paramètres
hDevice
Handle de l’appareil d’affichage (contexte graphique).
unnamedParam2
pData [in, out]
Pointeur vers une structure de D3DDDIARG_GETOVERLAYCOLORCONTROLS qui décrit les paramètres de récupération des paramètres de contrôle des couleurs d’une superposition.
Valeur retournée
GetOverlayColorControls retourne l’une des valeurs suivantes :
| Code de retour | Description |
|---|---|
| S_OK | Les paramètres de contrôle des couleurs ont été récupérés avec succès. |
| E_INVALIDARG | Les paramètres ont été validés et déterminés comme incorrects. |
| E_OUTOFMEMORY | GetOverlayColorControls n’a pas pu allouer la mémoire nécessaire pour qu’il se termine. |
Remarques
Le runtime Microsoft Direct3D appelle la fonction GetOverlayColorControls pour renvoyer les paramètres actuels 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 GetOverlayColorControls pour une superposition qui n’est pas encore visible. Dans ce cas, lorsque le membre hOverlay de la structure D3DDDIARG_GETOVERLAYCOLORCONTROLS pointée par pData est défini sur NULL, le pilote doit retourner les paramètres de contrôle de couleur par défaut du matériel de superposition.
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) |