DXGK_DIAGNOSTIC_PSR-Struktur (dispmprt.h)

Eine Diagnose, die angibt, dass der bereich, der über das Ziel im Feld TargetId in der DXGK_DIAGNOSTIC_HEADER-Struktur verbunden ist, einen Panel-Selbstaktualisierungsstatus (PSR) betreten 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;

Member

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 keines festgelegt ist, angibt, dass das Ziel in PSR eingibt.

Value

Wert des PSR.

Hinweise

Wenn der Bereich in die Selbstaktualisierung wechselt, sollte der Treiber diese Diagnose senden, wobei keines der Bitfelder im Feld RefreshReason festgelegt ist.

Wenn der Bereich die Selbstaktualisierung beenden muss, um den Inhalt zu aktualisieren, sollte der Treiber diese Diagnose mit mindestens einem der Bitfelder in RefreshReason senden, um die Gründe für das Beenden von PSR anzugeben. 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 Trigger zum Beenden von PSR war, als alle Gründe zu erfassen, die die Beendigung ausgelöst haben. Dies liegt daran, dass der Fahrer nach dem Beenden der PSR keine zusätzlichen Gründe dafür melden sollte, dass PSR beendet worden wäre, sodass die Meldung gültig ist, solange mindestens ein Grund angegeben wird.

Wenn der Bereich und der Treiber PSR2 unterstützen, bei denen Updates keinen vollständigen Frame an den Bereich senden müssen, um einen kleineren Teil zu aktualisieren, sollten solche Updates weiterhin an das Betriebssystem gemeldet werden, während PSR beendet wird. Wenn sich die Anzeige beispielsweise in PSR befindet und die Cursorform ohne andere Updates geändert wird, sollte der Treiber in der Lage sein, einen kleinen Bruchteil des vollständigen Bilds von Pixeln zu senden, wahrscheinlich nur die Zeilen, die den Cursor enthalten. In diesem Fall sollte der Treiber weiterhin melden, dass PSR mit CursorUpdate-Grund beendet wurde. 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