DXGK_DIAGNOSTIC_PSR 構造体 (dispmprt.h)

DXGK_DIAGNOSTIC_HEADER構造体の TargetId フィールドのターゲットを介して接続されたパネルが、パネルの自己更新 (PSR) 状態に入ったか終了したことを示す診断。

構文

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

メンバー

Header

報告される診断の種類を示す DXGK_DIAGNOSTIC_HEADER 構造体。

RefreshReason

PSR を終了する理由または理由を示す一連の DXGK_DIAGNOSTIC_PSR_REFRESH_REASON ビット・フィールド、または何も設定されていない場合は、ターゲットが PSR に入っていることを示します。

Value

PSR の値。

注釈

パネルが自己更新に入ると、ドライバーは RefreshReason フィールドに設定されたビット フィールドを指定してこの診断を送信する必要があります。

パネルが自己更新を終了してコンテンツを更新する必要がある場合、ドライバーは、PSR を終了する理由を示す RefreshReason 内のビット フィールドの少なくとも 1 つでこの診断を送信する必要があります。 複数の要因によって PSR が終了した場合、ドライバーはすべての適切なビット フィールドの理由を設定する必要があります。 ただし、理由が PSR を終了するトリガーではない場合は、終了をトリガーしたすべての理由をキャプチャするよりも、フラグを設定しない方が重要です。 これは、PSR が終了した後、少なくとも 1 つの理由が指定されている限り、ドライバーは PSR が終了した可能性がある追加の理由を報告しないようにする必要があるためです。

パネルとドライバーが PSR2 をサポートしている場合、更新プログラムでは小さな部分を更新するためにフル フレームをパネルに送信する必要はありません。このような更新プログラムは、PSR の終了時に引き続き OS に報告する必要があります。 たとえば、ディスプレイが PSR にあり、カーソルの形状が他の更新なしで変更された場合、ドライバーはピクセルの完全なフレームのごく一部を送信でき、おそらくカーソルを含む行のみを送信できる必要があります。 この場合でも、ドライバーは PSR が終了したことを CursorUpdate という理由で報告する必要があります。 後のリリースでは、部分的な更新と完全な更新を区別するために、追加の診断フィールドが追加される可能性があります。

要件

要件	値
Header	dispmprt.h