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) |