PFND3DDDI_SETOVERLAYCOLORCONTROLS funzione di callback (d3dumddi.h)

  • Articolo

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 di controllo dei colori 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 come non corretti.
E_OUTOFMEMORY SetOverlayColorControls non è riuscito ad allocare la memoria necessaria per il completamento.

Commenti

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 dei colori associate a una sovrimpressione specifica.

Il runtime può anche chiamare SetOverlayColorControls per una sovrimpressione non ancora visibile. In questo caso, quando il membro hOverlay 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.

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_SETOVERLAYCOLORCONTROLS

D3DDDI_DEVICEFUNCS