drvSynchronizeSurface 函式 (winddi.h)
DrvSynchronizeSurface函式會通知驅動程式 GDI 需要寫入指定的表面。 此函式可讓裝置的共同處理器所執行的繪圖作業與 GDI 協調。
語法
void DrvSynchronizeSurface(
SURFOBJ *pso,
RECTL *prcl,
FLONG fl
);
參數
pso
SURFOBJ結構的指標，識別繪圖同步處理發生所在的表面。
prcl
指定 RECTL 結構，代表 GDI 將繪製到的介面或 Null。 如果這不會與進行中的繪圖作業衝突，驅動程式可以選擇讓 GDI 繪製，而不需要等待共同處理器完成。
fl
這是旗標，指定 GDI 發出同步處理要求的事件。 此參數可以是下列其中一個值：
DSS_TIMER_EVENT
GDI 因為同步處理計時器事件而呼叫此函式。 只有指定 DEVINFO 結構的GCAPS2_SYNCTIMER位的驅動程式才會產生計時器事件。
DSS_FLUSH_EVENT
GDI 因為同步處理排清事件而呼叫此函式。 這些排清事件只會針對指定 DEVINFO 結構的GCAPS2_SYNCFLUSH位的驅動程式產生。
傳回值
無
備註
此函式可讓裝置的共同處理器所執行的繪圖作業與 GDI 協調。
DrvSynchronizeSurface 可以在顯示驅動程式中選擇性地實作。 只有在 EngAssociateSurface攔截此函式時，GDI 才會呼叫此函式。 GDI 會在直接繪製到裝置介面之前呼叫 DrvSynchronizeSurface 。
DrvSynchronizeSurface 旨在支援使用共同處理器繪製的裝置。 這類裝置可以啟動很長的繪圖作業，並在作業繼續時返回 GDI。 如果設備磁碟機未對表面執行所有繪圖作業，則 GDI 可能會處理後續的繪圖作業。 在此情況下，GDI 必須等候協同處理器完成其工作，才能在 GDI 上繪製。
當 GDI 在 由中國指定的矩形區域內的介面上繪製時，此函式應該會傳回 。
DrvSynchronizeSurface 本身不是輸出函式。
規格需求
| 目標平台 | 桌上型 |
| 標頭 | winddi.h (包含 Winddi.h) |