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