D3DKMDT_STAGINGSURFACEDATA構造体 (d3dkmdt.h)
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値で指定) として作成されます。 ステージング サーフェスの寸法は常にバック バッファーの寸法と一致するため、ステージング サーフェスに対する現在の操作ではストレッチ操作や圧縮操作は必要ありません。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista |
| ヘッダー | d3dkmdt.h (D3dkmddi.h を含む) |
関連項目
D3DKMDT_STANDARDALLOCATION_TYPE
DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA
DxgkDdiCreateAllocation の
DxgkDdiGetStandardAllocationDriverData の