Partager via


DXGK_INHERITED_TIMING_INFO structure (d3dkmddi.h)

Structure transmise au pilote dans l’argument pPrivateDriverData de DxgkDdiRecommendFunctionalVidPn, que le pilote doit utiliser pour décrire l’espace de couleur et le format de fil qui ne peuvent pas être décrits facilement dans le VidPn généré par DDI

Syntaxe

typedef struct _DXGK_INHERITED_TIMING_INFO {
  union {
    D3DDDI_COLOR_SPACE_TYPE             OutputColorSpace;
    D3DDDI_OUTPUT_WIRE_COLOR_SPACE_TYPE OutputWireColorSpace;
  };
  D3DKMDT_WIRE_FORMAT_AND_PREFERENCE SelectedWireFormat;
  union {
    struct {
      DXGK_GLITCH_CAUSE    GlitchCause;
      DXGK_GLITCH_EFFECT   GlitchEffect;
      DXGK_GLITCH_DURATION GlitchDuration;
      UINT8                Reserved;
    };
    UINT DiagnosticInfo;
  };
} DXGK_INHERITED_TIMING_INFO, *PDXGK_INHERITED_TIMING_INFO;

Membres

OutputColorSpace

Valeur D3DDDI_COLOR_SPACE_TYPE qui décrit l’espace de couleur de sortie actuellement appliqué aux pixels transportés. Le pilote est chargé d’envoyer les métadonnées appropriées pour s’assurer que le périphérique d’affichage est configuré pour interpréter correctement les pixels pour cet espace de couleurs.

OutputWireColorSpace

SelectedWireFormat

Valeur D3DKMDT_WIRE_FORMAT_AND_PREFERENCE qui indique le format de fil qui est réellement utilisé. Bien que le mode cible épinglé dans le VidPn retourné par l’appel à DxgkDdiRecommendFunctionalVidPn puisse être requis pour décrire exactement un format de fil, cela peut nécessiter que le pilote prépare un mode cible spécial uniquement pour le cas de démarrage. Au lieu de cela, ce champ doit être utilisé pour signaler le format d’encodage de couleur de fil actuel et les bits par canal de couleur. Le format signalé dans ce champ doit également avoir été signalé comme pris en charge dans le mode cible signalé via DxgkDdiRecommendFunctionalVidPn.

GlitchCause

Valeur DXGK_GLITCH_CAUSE qui indique quelle modification sous-jacente ou quelles modifications dans le pipeline d’affichage ont provoqué un problème perceptible par l’utilisateur.

GlitchEffect

Valeur DXGK_GLITCH_EFFECT qui indique à quoi ressemblait le problème pour un utilisateur.

GlitchDuration

Valeur DXGK_GLITCH_DURATION qui indique approximativement la durée du problème. Notez que cela est destiné à refléter la durée pendant laquelle le problème sous-jacent était présent, mais l’effet visible peut être plus long dans certains cas. Par exemple, lorsque la synchronisation est perdue suffisamment longtemps pour qu’un moniteur ait à réétenter, la récupération de l’appareil d’affichage prendra probablement de nombreuses images. C’est la longueur du problème sous-jacent qui doit être signalée, et non le temps de récupération, car cela varie d’un appareil à l’autre.

Reserved

L’utilisation de cette valeur est réservée au système.

DiagnosticInfo

Ensemble d’informations renseignées par le pilote pour l’affichage de démarrage afin de décrire les effets secondaires de l’appareil DxgkDdiStartDevice.

Dans de nombreux cas, les problèmes étant inévitables, ces champs tentent de comprendre la cause sous-jacente et l’étendue de l’impact sur l’utilisateur. Les fabricants OEM et les clients se plaignent souvent de problèmes lors du démarrage. Le fait que le pilote signale le problème au système d’exploitation devrait aider à examiner ces problèmes rapidement.

Configuration requise

Condition requise Valeur
En-tête d3dkmddi.h