Compartir a través de

DXGKDDI_SETTARGETADJUSTEDCOLORIMETRY función de devolución de llamada (dispmprt.h)

  • Artículo

Notifica los valores de colorimetría seleccionados por el sistema operativo para un destino.

Sintaxis

DXGKDDI_SETTARGETADJUSTEDCOLORIMETRY DxgkddiSettargetadjustedcolorimetry;

NTSTATUS DxgkddiSettargetadjustedcolorimetry(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN D3DDDI_VIDEO_PRESENT_TARGET_ID TargetId,
  [in] IN DXGK_COLORIMETRY AdjustedColorimetry
)
{...}

Parámetros

[in] hAdapter

[in] Identifica el adaptador.

[in] TargetId

[in] El identificador del destino de vídeo del adaptador de pantalla.

[in] AdjustedColorimetry

[in] Estructura de DXGK_COLORIMETRY que contiene los campos relacionados con la colorimetría del monitor asociado a este destino después de que el sistema operativo haya procesado el descriptor del dispositivo de visualización, todas las invalidaciones y los ajustes.

Valor devuelto

El controlador devuelve STATUS_SUCCESS si actualiza sus valores de colorimetría en función de los datos proporcionados.

Si se produce un error en el controlador, el sistema operativo revertirá a los valores estándar de SDR para todos los parámetros, 709 principales, 2,2 gamma y 8-nit por componente de color formato de cable RGB, pero no llamará al controlador, ya que nunca debería producir un error. En su lugar, el controlador también debe actualizar su representación interna del dispositivo de pantalla para que sea SDR estándar.

Comentarios

Dado que se ha encontrado que los dispositivos de pantalla actuales tienen descripciones incompletas e inexactas de sus parámetros relacionados con la colorimetría, se necesitan invalidaciones. Las invalidaciones tienen dos formas: invalidaciones de controlador y invalidaciones del sistema operativo para parámetros no válidos. En futuras versiones del sistema operativo, se espera que se implementen invalidaciones adicionales. Para mantener el controlador sincronizado con los parámetros que usa el sistema operativo, el sistema operativo llamará a DxgkDdiSetTargetAdjustedColorimetry para cada destino.

Normalmente, esta llamada solo se realizará una vez que se haya consultado el controlador para las invalidaciones y la validación del sistema operativo se haya completado, pero antes de que se active la pantalla. Cuando el sistema operativo tiene otras formas de invalidaciones, es posible que lleguen después de que la pantalla ya esté activa. En este caso, el sistema operativo seguirá actualizando el controlador que se espera que realice las actualizaciones necesarias para su canalización de visualización en dos fotogramas. Si es necesario, el controlador debe deslizar la salida de la pantalla para aplicar el cambio.

FormatBitDepths y StandardColorimetryFlags de la DXGK_COLORIMETRY están a cero, ya que son campos de funcionalidad, por lo que solo son válidos en las consultas.

Esta función siempre se llama en el nivel PASIVO, por lo que el código auxiliar se debe paginar siempre que sea posible.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado dispmprt.h