DrvSaveScreenBits 函式 (winddi.h)

  • 發行項

DrvSaveScreenBits 函式會導致顯示驅動程式儲存或還原所顯示影像的指定矩形。

語法

ULONG_PTR DrvSaveScreenBits(
  SURFOBJ   *pso,
  ULONG     iMode,
  ULONG_PTR ident,
  RECTL     *prcl
);

參數

pso

描述表面之 SURFOBJ 結構的指標。

iMode

指定要執行的作業。 此參數可以是下列其中一個值：

SS_SAVE

驅動程式應該從 中國所定義的矩形儲存數據。 驅動程式負責在其 螢幕外記憶體中管理此數據。 會忽略 ident 參數。

成功時， DrvSaveScreenBits 應該會傳回已儲存數據的標識碼。 驅動程式可以傳回句柄，甚至傳回其螢幕外記憶體的指標。 如果函式失敗，此函式會傳回零。

SS_RESTORE

驅動程式應該會將 ident 識別的數據還原到顯示器上的 矩形中國; 也就是說，驅動程式應該將點陣圖還原為其原始位置。 驅動程式可以假設 中國 矩形的大小與儲存的矩形完全相同。 此呼叫之後應該捨棄數據。

如果數據已還原到顯示器，DrvSaveScreenBits 應該會傳回 TRUE，如果無法還原數據則傳回 FALSE。

SS_FREE

不再需要由 ident 識別的數據，而且可以釋出。 中國的值未定義，不應使用。 驅動程式不應該將儲存的矩形還原到顯示器。

DrvSaveScreenBits 應該會傳回 TRUE。

ident

如果 iMode 是SS_RESTORE或SS_FREE，則先前呼叫 DrvSaveScreenBits 所傳回的驅動程式定義值指標。 當 iMode SS_SAVE時，驅動程序應該忽略此參數。

prcl

RECTL 結構的指標，定義要儲存或還原的螢幕部分。

傳回值

傳回值取決於 iMode 參數的值。

備註

某些顯示器驅動程式可能會比重新繪製區域快得多，將數據移入或移出螢幕外裝置記憶體。 當視窗管理員必須顯示功能表或對話框時，這可能很有用。

DrvSaveScreenBits 是顯示驅動程式的選擇性專案。

規格需求

需求 值
目標平台 桌面
標頭 winddi.h (包含Winddi.h)

另請參閱

SURFOBJ