D3DKMDT_SHADOWSURFACEDATA構造体 (d3dkmdt.h)

[アーティクル]
05/18/2024

D3DKMDT_SHADOWSURFACEDATA構造は、特定の表示モードの形式と解像度でプライマリサーフェスと一致するロック可能なシャドウサーフェスを表します。

構文

typedef struct _D3DKMDT_SHADOWSURFACEDATA {
  [in]  UINT         Width;
  [in]  UINT         Height;
  [in]  D3DDDIFORMAT Format;
  [out] UINT         Pitch;
} D3DKMDT_SHADOWSURFACEDATA;

メンバー

[in] Width

サーフェスの幅 (ピクセル単位)。ドライバーは幅の値を返します。

[in] Height

サーフェスの高さ (ピクセル単位)。ドライバーは高さの値を返します。

[in] Format

サーフェスのピクセル形式を示す D3DDDIFORMAT型指定の値。ドライバーは、書式の値を返します。

[out] Pitch

サーフェスの幅 (バイト単位)。シャドウサーフェスはロック可能であるため、ドライバーはピッチ値を返す必要があります。

注釈

D3DKMDT_SHADOWSURFACEDATA構造体は、Microsoft DirectX グラフィックスカーネルサブシステムによって、ディスプレイミニポートドライバーの DxgkDdiGetStandardAllocationDriverData 関数の呼び出しで渡され、ロック可能なシャドウサーフェスの説明を生成します。 DirectX グラフィックスカーネルサブシステムは、ディスプレイミニポートドライバーの DxgkDdiCreateAllocation 関数の呼び出しで説明を使用して、ロック可能なシャドウサーフェスを作成します。

CPU はロックされたシャドウサーフェスに引き込み、シャドウサーフェスのロックを解除してから、シャドウサーフェスから一致する共有プライマリサーフェスに DxgkDdiPresent 関数を介してビットブロック転送 (ビットブレット) 要求を発行します。ビットブロック転送要求は、共有プライマリサーフェスからシャドウサーフェスにデータを転送するためにも発行されます。

シャドウサーフェスとの間でデータをコピーする場合、カラー変換、ストレッチ、または縮小操作は必要ありません。これは、シャドウサーフェスと共有プライマリサーフェスのソースとターゲットの形式と寸法が常に一致するためです。