PFND3DDDI_SETOVERLAYCOLORCONTROLS funzione di callback (d3dumddi.h)
La funzione SetOverlayColorControls modifica le impostazioni del controllo colore per la sovrimpressione specificata.
Sintassi
PFND3DDDI_SETOVERLAYCOLORCONTROLS Pfnd3dddiSetoverlaycolorcontrols;
HRESULT Pfnd3dddiSetoverlaycolorcontrols(
HANDLE hDevice,
const D3DDDIARG_SETOVERLAYCOLORCONTROLS *unnamedParam2
)
{...}
Parametri
hDevice
Handle per il dispositivo di visualizzazione (contesto grafico).
unnamedParam2
pData [in]
Puntatore a una struttura D3DDDIARG_SETOVERLAYCOLORCONTROLS che descrive i parametri per la modifica delle impostazioni del controllo colore di una sovrimpressione.
Valore restituito
SetOverlayColorControls restituisce uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
| S_OK | Le impostazioni del controllo colore sono state modificate correttamente. |
| E_INVALIDARG | I parametri sono stati convalidati e sono stati determinati in modo che non siano corretti. |
| E_OUTOFMEMORY | SetOverlayColorControls non è riuscito ad allocare la memoria necessaria per il completamento. |
Osservazioni
Il runtime di Microsoft Direct3D chiama la funzione SetOverlayColorControls per modificare 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 SetOverlayColorControls per una sovrimpressione non ancora visibile. In questo caso, quando il hOverlay membro della struttura D3DDDIARG_SETOVERLAYCOLORCONTROLS a cui punta pData è impostato su NULL, il driver deve archiviare le impostazioni del controllo colore fornite e usarle quando viene creata una sovrimpressione che fa riferimento alla risorsa specificata.
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) |