PFND3DDDI_GETOVERLAYCOLORCONTROLS funzione di callback (d3dumddi.h)
La funzione GetOverlayColorControls recupera le impostazioni del controllo colore per la sovrapposizione 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 di controllo colore di una sovrapposizione.
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 determinati per essere non corretti. |
| E_OUTOFMEMORY | GetOverlayColorControls non è riuscito a allocare la memoria necessaria per il completamento. |
Commenti
Il runtime di Microsoft Direct3D chiama la funzione GetOverlayColorControls per restituire la luminosità corrente, il contrasto, la saturazione, la saturazione, la nitidezza, la gamma e le impostazioni di abilitazione dei colori associate a una sovrapposizione specifica.
Il runtime può anche chiamare GetOverlayColorControls per una sovrapposizione che non è ancora visibile. In questa situazione, quando il membro hOverlay della struttura D3DDDIARG_GETOVERLAYCOLORCONTROLS puntato a pData è impostato su NULL, il driver deve restituire le impostazioni di controllo colore predefinite dell'hardware di sovrimpressione.
Requisiti
| 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) |