drvSynchronizeSurface 函式 (winddi.h)

DrvSynchronizeSurface函式會通知驅動程式 GDI 需要寫入指定的表面。此函式可讓裝置的共同處理器所執行的繪圖作業與 GDI 協調。

語法

void DrvSynchronizeSurface(
  SURFOBJ *pso,
  RECTL   *prcl,
  FLONG   fl
);

pso

SURFOBJ結構的指標，識別繪圖同步處理發生所在的表面。

prcl

指定 RECTL 結構，代表 GDI 將繪製到的介面或 Null。如果這不會與進行中的繪圖作業衝突，驅動程式可以選擇讓 GDI 繪製，而不需要等待共同處理器完成。

fl

這是旗標，指定 GDI 發出同步處理要求的事件。此參數可以是下列其中一個值：

GDI 因為同步處理計時器事件而呼叫此函式。只有指定 DEVINFO 結構的GCAPS2_SYNCTIMER位的驅動程式才會產生計時器事件。

GDI 因為同步處理排清事件而呼叫此函式。這些排清事件只會針對指定 DEVINFO 結構的GCAPS2_SYNCFLUSH位的驅動程式產生。

無

此函式可讓裝置的共同處理器所執行的繪圖作業與 GDI 協調。

DrvSynchronizeSurface 可以在顯示驅動程式中選擇性地實作。只有在 EngAssociateSurface攔截此函式時，GDI 才會呼叫此函式。 GDI 會在直接繪製到裝置介面之前呼叫 DrvSynchronizeSurface 。

DrvSynchronizeSurface 旨在支援使用共同處理器繪製的裝置。這類裝置可以啟動很長的繪圖作業，並在作業繼續時返回 GDI。如果設備磁碟機未對表面執行所有繪圖作業，則 GDI 可能會處理後續的繪圖作業。在此情況下，GDI 必須等候協同處理器完成其工作，才能在 GDI 上繪製。

當 GDI 在 由中國指定的矩形區域內的介面上繪製時，此函式應該會傳回。

DrvSynchronizeSurface 本身不是輸出函式。


目標平台	桌上型
標頭	winddi.h (包含 Winddi.h)