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