PFND3DDDI_SETOVERLAYCOLORCONTROLS función de devolución de llamada (d3dumddi.h)

  • Artículo

La función SetOverlayColorControls cambia la configuración del control de color de la superposición especificada.

Sintaxis

PFND3DDDI_SETOVERLAYCOLORCONTROLS Pfnd3dddiSetoverlaycolorcontrols;

HRESULT Pfnd3dddiSetoverlaycolorcontrols(
  HANDLE hDevice,
  const D3DDDIARG_SETOVERLAYCOLORCONTROLS *unnamedParam2
)
{...}

Parámetros

hDevice

Identificador del dispositivo de visualización (contexto de gráficos).

unnamedParam2

pData [in]

Puntero a una estructura de D3DDDIARG_SETOVERLAYCOLORCONTROLS que describe los parámetros para cambiar la configuración de control de color de una superposición.

Valor devuelto

SetOverlayColorControls devuelve uno de los siguientes valores:

Código devuelto Descripción
S_OK La configuración del control de color se cambió correctamente.
E_INVALIDARG Los parámetros se validaron y determinaron que son incorrectos.
E_OUTOFMEMORY SetOverlayColorControls no pudo asignar la memoria necesaria para que se complete.

Comentarios

El tiempo de ejecución de Microsoft Direct3D llama a la función SetOverlayColorControls para cambiar el brillo, el contraste, el tono, la saturación, la nitidez, la gamma y la configuración de habilitación de colores asociada a una superposición específica.

El entorno de ejecución también puede llamar a SetOverlayColorControls para una superposición que aún no está visible. En esta situación, cuando el miembro hOverlay de la estructura de D3DDDIARG_SETOVERLAYCOLORCONTROLS a la que apunta pData se establece en NULL, el controlador debe almacenar la configuración de control de color proporcionada y usarlas cuando se cree una superposición que haga referencia al recurso especificado.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino Escritorio
Encabezado d3dumddi.h (incluya D3dumddi.h)

Consulte también

D3DDDIARG_SETOVERLAYCOLORCONTROLS

D3DDDI_DEVICEFUNCS