Condividi tramite


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)

Vedi anche

D3DDDIARG_GETOVERLAYCOLORCONTROLS

D3DDDI_DEVICEFUNCS