DXGKDDI_SETTARGETADJUSTEDCOLORIMETRY fonction de rappel (dispmprt.h)

Article
02/06/2025

Signale les valeurs de colorimétrie 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 vidéo d’une carte d’affichage cible présente.

[in] AdjustedColorimetry

[in] Structure DXGK_COLORIMETRY contenant les champs associés aux colorimétries du moniteur attaché à cette cible une fois que le système d’exploitation a traité le descripteur d’appareil d’affichage, tous les remplacements et tous les ajustements.

Valeur de retour

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

Si le pilote échoue, le système d’exploitation revient aux valeurs SDR standard pour tous les paramètres, 709 primaires, 2,2 gamma et 8 nit par format de câble RVB du composant 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 de l’appareil d’affichage pour qu’il soit SDR standard.

Remarques

Étant donné que les appareils d’affichage actuels ont été trouvés avoir des descriptions incomplètes et inexactes de leurs paramètres liés aux colorimétries, les 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 futures versions du système d’exploitation, il est prévu que des remplacements supplémentaires soient implémentés. Pour maintenir la synchronisation du pilote avec les paramètres que le système d’exploitation utilise, le système d’exploitation appelle DxgkDdiSetTargetAdjustedColorimetry pour chaque cible.

En règle générale, cet appel ne sera effectué qu’une fois que le pilote a été interrogé pour les remplacements et que la validation du système d’exploitation s’est terminée, mais avant l’activation de l’affichage. Lorsque le système d’exploitation a d’autres formes de substitutions, il est possible qu’ils arrivent une fois l’affichage 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 faire glisser la sortie d’affichage pour appliquer la modification.

Les formats FormatBitDepths et StandardColorimetryFlags dans l’DXGK_COLORIMETRY sont zéros, car il s’agit de champs de capacité, donc uniquement valides dans les requêtes.

Cette fonction est toujours appelée au niveau passif afin que le code de prise en charge soit rendu paginable dans la mesure du possible.

Exigences

Exigence	Valeur
plateforme cible	Windows
d’en-tête	dispmprt.h

Partager via