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結構是由 Microsoft DirectX 圖形核心子系統在呼叫顯示迷你埠驅動程式的 DxgkDdiGetStandardAllocationDriverData 函式時傳遞，以產生可鎖定暫存介面的描述。圖形子系統會呼叫 display miniport 驅動程式的 DxgkDdiPresent 函式，以發出 bit-block transfer (bitblt) 要求，以將數據從應用程式的後台緩衝區傳輸到預備介面。暫存介面接著會由CPU鎖定和讀取。

當直接位區塊傳送至主要表面時，可能會為目前作業建立暫存 (表面，例如在多監視器或 sprites 案例中) 。

這個暫存介面一律會建立為每色 8 位 RGB 像素格式， (由 D3DDDIFORMAT列舉) 中的D3DDDIFMT_X8R8G8B8值所指定。因為暫存介面的維度一律符合上層緩衝區的維度，所以目前作業不需要延展或壓縮作業到暫存介面。