PFND3DDDI_GETOVERLAYCOLORCONTROLS funzione di callback (d3dumddi.h)
La funzione GetOverlayColorControls recupera le impostazioni del controllo colore per la sovrimpressione specificata.
Sintassi
PFND3DDDI_GETOVERLAYCOLORCONTROLS Pfnd3dddiGetoverlaycolorcontrols;
HRESULT Pfnd3dddiGetoverlaycolorcontrols(
HANDLE hDevice,
D3DDDIARG_GETOVERLAYCOLORCONTROLS *unnamedParam2
)
{...}
Parametri
hDevice
Handle per il dispositivo di visualizzazione (contesto grafico).
unnamedParam2
pData [in, out]
Puntatore a una struttura D3DDDIARG_GETOVERLAYCOLORCONTROLS che descrive i parametri per il recupero delle impostazioni del controllo colore di una sovrimpressione.
Valore restituito
GetOverlayColorControls restituisce uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
| S_OK | Le impostazioni del controllo colore sono state recuperate correttamente. |
| E_INVALIDARG | I parametri sono stati convalidati e sono stati determinati in modo che non siano corretti. |
| E_OUTOFMEMORY | GetOverlayColorControls non è riuscito ad allocare la memoria necessaria per il completamento. |
Osservazioni
Il runtime di Microsoft Direct3D chiama la funzione GetOverlayColorControls per restituire la luminosità, il contrasto, la tonalità, la saturazione, la nitidezza, la gamma e le impostazioni di abilitazione del colore associate a una sovrimpressione specifica.
Il runtime può anche chiamare GetOverlayColorControls per una sovrimpressione non ancora visibile. In questo caso, quando il hOverlay membro della struttura D3DDDIARG_GETOVERLAYCOLORCONTROLS a cui punta pData è impostato su NULL, il driver deve restituire le impostazioni predefinite del controllo colore dell'hardware di sovrimpressione.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
| piattaforma di destinazione | Desktop |
| intestazione | d3dumddi.h (include D3dumddi.h) |