DXGK_DIAGNOSTIC_PSR Struktur (dispmprt.h)

Eine Diagnose, die angibt, dass das Panel, das über das Ziel im TargetId Feld in der DXGK_DIAGNOSTIC_HEADER Struktur verbunden ist, einen Panel-Selbstaktualisierungsstatus (Self-Refresh, PSR) eingegeben oder beendet hat.

Syntax

typedef struct _DXGK_DIAGNOSTIC_PSR {
  DXGK_DIAGNOSTIC_HEADER Header;
  union {
    DXGK_DIAGNOSTIC_PSR_REFRESH_REASON RefreshReason;
    UINT                               Value;
  };
} DXGK_DIAGNOSTIC_PSR;

Angehörige

Header

Eine DXGK_DIAGNOSTIC_HEADER Struktur, die angibt, welche Art von Diagnose gemeldet wird.

RefreshReason

Eine Reihe von DXGK_DIAGNOSTIC_PSR_REFRESH_REASON Bitfeldern, die den Grund oder die Gründe für das Beenden von PSR angeben oder, wenn keine festgelegt ist, angibt, dass das Ziel PSR eingibt.

Value

Wert des PSR.

Bemerkungen

Wenn der Bereich die Selbstaktualisierung eingibt, sollte der Treiber diese Diagnose mit keinem der Bitfelder senden, die im Feld RefreshReason festgelegt sind.

Wenn das Panel die Selbstaktualisierung beenden muss, um den Inhalt zu aktualisieren, sollte der Treiber diese Diagnose mit mindestens einem der Bitfelder innerhalb von RefreshReason senden, der die Gründe für das Beenden von PSR angibt. Wenn mehrere Faktoren dazu geführt haben, dass PSR beendet wurde, sollte der Treiber versuchen, alle geeigneten Bitfeldgründe festzulegen. Es ist jedoch wichtiger, dass Flags nicht festgelegt werden sollten, wenn der Grund nicht der Auslöser zum Beenden von PSR war, als alle Gründe zu erfassen, die den Exit ausgelöst haben. Dies liegt daran, dass der Fahrer nach dem Verlassen des PSR nicht mehr zusätzliche Gründe melden sollte, die psR beendet hätte, sodass die Berichterstattung gültig wäre, solange mindestens ein Grund angegeben wird.

Wenn das Panel und der Treiber PSR2 unterstützen, für den Updates kein vollständiger Frame an das Panel gesendet werden muss, um einen kleineren Teil zu aktualisieren, sollten diese Updates beim Beenden von PSR weiterhin an das Betriebssystem gemeldet werden. Wenn sich die Anzeige z. B. in PSR befindet und das Cursor-Shape ohne andere Aktualisierungen geändert wird, sollte der Treiber in der Lage sein, einen kleinen Bruchteil des gesamten Pixelrahmens zu senden, wahrscheinlich nur die Linien, die den Cursor enthalten. In diesem Fall sollte der Treiber weiterhin melden, dass PSR beendet wurde, mit Grund CursorUpdate. In einer späteren Version können zusätzliche Diagnosefelder hinzugefügt werden, um partielle und vollständige Updates zu unterscheiden.

Anforderungen

Anforderung	Wert
Header-	dispmprt.h