DXGKDDI_SETTARGETADJUSTEDCOLORIMETRY fonction de rappel (dispmprt.h)

Signale les valeurs colorimétriques sélectionnées par le système d’exploitation pour une cible.

Syntaxe

DXGKDDI_SETTARGETADJUSTEDCOLORIMETRY DxgkddiSettargetadjustedcolorimetry;

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

Paramètres

[in] hAdapter

[in] Identifie l’adaptateur.

[in] TargetId

[in] Identificateur de la cible actuelle de la vidéo d’un adaptateur d’affichage.

[in] AdjustedColorimetry

[in] Structure DXGK_COLORIMETRY contenant les champs liés à la colorimétrie pour le moniteur attaché à cette cible une fois que le système d’exploitation a traité le descripteur de périphérique d’affichage, tous les remplacements et tous les ajustements.

Valeur retournée

Le pilote retourne STATUS_SUCCESS s’il a mis à jour ses valeurs de colorimétrie en fonction des données fournies.

En cas d’échec du pilote, le système d’exploitation rétablit les valeurs SDR standard pour tous les paramètres, 709 primaires, 2,2 gamma et 8 nits par composant de couleur, mais il n’appelle pas le pilote, car cela ne devrait jamais échouer. Au lieu de cela, le pilote doit également mettre à jour sa représentation interne du périphérique d’affichage en SDR standard.

Remarques

Étant donné que les appareils d’affichage actuels ont des descriptions incomplètes et inexactes de leurs paramètres liés à la colorimétrie, des remplacements sont nécessaires. Les remplacements prennent deux formes : les remplacements de pilotes et les remplacements de système d’exploitation pour les paramètres non valides. Dans les versions futures du système d’exploitation, des remplacements supplémentaires devraient être implémentés. Pour maintenir la synchronisation du pilote avec les paramètres utilisés par le système d’exploitation, le système d’exploitation appelle DxgkDdiSetTargetAdjustedColorimetry pour chaque cible.

En règle générale, cet appel n’est effectué qu’une fois que le pilote a été interrogé pour les remplacements et que la validation du système d’exploitation est terminée, mais avant l’activation de l’affichage. Lorsque le système d’exploitation a d’autres formes de remplacements, il est possible qu’ils arrivent une fois que l’affichage est déjà actif. Dans ce cas, le système d’exploitation met toujours à jour le pilote qui est censé effectuer les mises à jour nécessaires à son pipeline d’affichage dans deux images. Si nécessaire, le pilote doit glisser la sortie d’affichage afin d’appliquer la modification.

Les valeurs FormatBitDepths et StandardColorimetryFlags dans le DXGK_COLORIMETRY sont mises à zéro, car il s’agit de champs de capacité, donc uniquement valides dans les requêtes.

Cette fonction étant toujours appelée au niveau PASSIF, le code de prise en charge doit être rendu paginable dans la mesure du possible.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	dispmprt.h