D3DKMDT_STAGINGSURFACEDATA 構造体 (d3dkmdt.h)

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

D3DKMDT_STAGINGSURFACEDATA構造体は、アプリケーションのバックバッファーからデータが転送されるロック可能なステージングサーフェイスを記述します。

構文

typedef struct _D3DKMDT_STAGINGSURFACEDATA {
  [in]  UINT Width;
  [in]  UINT Height;
  [out] UINT Pitch;
} D3DKMDT_STAGINGSURFACEDATA;

メンバー

[in] Width

ステージングバッファーの幅 (ピクセル単位)。

[in] Height

ステージングバッファーの高さ (ピクセル単位)。

[out] Pitch

ステージングバッファーの幅 (バイト単位)。ステージングバッファーがロック可能であるため、ドライバーはピッチ値を返す必要があります。

注釈

D3DKMDT_STAGINGSURFACEDATA構造体は、ディスプレイミニポートドライバーの DxgkDdiGetStandardAllocationDriverData 関数の呼び出しで Microsoft DirectX グラフィックスカーネルサブシステムによって渡され、ロック可能なステージングサーフェイスの説明を生成します。グラフィックスサブシステムは、ディスプレイミニポートドライバーの DxgkDdiPresent 関数を呼び出して、アプリケーションのバックバッファーからステージングサーフェイスにデータを転送するビットブロック転送 (bitblt) 要求を発行します。その後、ステージング画面はロックされ、CPU によって読み取られます。

プライマリサーフェスへの直接ビットブロック転送が不可能な場合 (たとえば、マルチモニターやスプライトの場合) は、現在の操作に対してステージングサーフェスが作成される可能性があります。

このステージングサーフェイスは、常にカラーごとの 8 ビット RGB ピクセル形式 ( D3DDDIFORMAT 列挙体のD3DDDIFMT_X8R8G8B8値で指定) として作成されます。ステージングサーフェスの寸法は常にバックバッファーの寸法と一致するため、ステージングサーフェスに対する現在の操作にはストレッチ操作や圧縮操作は必要ありません。