DD_UPDATEOVERLAYDATA結構 (ddrawint.h)
DD_UPDATEOVERLAYDATA 結構包含更新重迭表面所需的資訊。
語法
typedef struct _DD_UPDATEOVERLAYDATA {
PDD_DIRECTDRAW_GLOBAL lpDD;
PDD_SURFACE_LOCAL lpDDDestSurface;
RECTL rDest;
PDD_SURFACE_LOCAL lpDDSrcSurface;
RECTL rSrc;
DWORD dwFlags;
DDOVERLAYFX overlayFX;
HRESULT ddRVal;
VOID *UpdateOverlay;
} *PDD_UPDATEOVERLAYDATA, DD_UPDATEOVERLAYDATA;
成員
lpDD
指向描述驅動程式裝置 的DD_DIRECTDRAW_GLOBAL 結構。
lpDDDestSurface
指向代表要重迭之 Microsoft DirectDraw 表面 的DD_SURFACE_LOCAL 結構。 如果在dwFlags中指定DDOVER_HIDE，這個值可以是Null。
rDest
指定要重載之目的地介面上區域的 x、y、寬度和高度 的 RECTL 結構。
lpDDSrcSurface
指向描述重迭表面的DD_SURFACE_LOCAL結構。
rSrc
指定要用於重迭之來源介面上區域的 x、y、寬度和高度的 RECTL 結構。
dwFlags
指定驅動程式如何處理重迭。 此成員可以是下列任何旗標的組合：
| 旗標 | 意義 |
|---|---|
| DDOVER_ADDDIRTYRECT | 驅動程式應該忽略。 |
| DDOVER_AUTOFLIP | 每當硬體視訊埠自動重設滑杆時，驅動程式應該會自動重迭重迭。 支援 視訊埠延伸模組的驅動程式 (VPE) 只需要檢查此旗標。 |
| DDOVER_BOB | 驅動程式應該個別顯示 VPE 物件資料的每個欄位，而不會造成任何抖動成品。 此旗標同時與 VPE 和解碼器有關，其想要使用核心模式視訊傳輸功能在核心模式中自行翻轉。 |
| DDOVER_BOBHARDWARE | 表示 bob 是由硬體而非軟體或模擬所執行。 支援 VPE 的驅動程式只需要檢查此旗標。 |
| DDOVER_DDFX | 驅動程式應該使用 overlayFX 成員所指定的屬性來顯示 重迭 表面。 |
| DDOVER_HIDE | 驅動程式應該隱藏重迭;也就是說，驅動程式應該關閉此重迭。 |
| DDOVER_INTERLEAVED | 重迭表面是由交錯的欄位所組成。 支援 VPE 的驅動程式只需要檢查此旗標。 |
| DDOVER_KEYDEST | 驅動程式應該使用與目的地介面相關聯的色彩索引鍵。 |
| DDOVER_KEYDESTOVERRIDE | 驅動程式應該使用 DDOVERLAYFX 結構 (的 dckDestColorKey 成員，) 作為目的地色彩索引鍵，而不是與目的地介面相關聯的色彩索引鍵。 |
| DDOVER_KEYSRC | 驅動程式應該使用與目的地介面相關聯的色彩索引鍵。 |
| DDOVER_KEYSRCOVERRIDE | 驅動程式應該使用 DDOVERLAYFX 結構的 dckSrcColorKey 成員， (DirectDraw SDK 檔中所述) 作為來源色彩索引鍵，而不是與目的地介面相關聯的色彩索引鍵。 |
| DDOVER_OVERRIDEBOBWEAVE | 其他介面不應覆寫 Bob/weave 決策。 如果重迭混音器設定此旗標，DirectDraw 不允許核心模式驅動程式使用核心模式視訊傳輸功能，在 bob 和 weave 模式之間切換硬體。 |
| DDOVER_REFRESHALL | 驅動程式應該忽略。 |
| DDOVER_REFRESHDIRTYRECTS | 驅動程式應該忽略。 |
| DDOVER_SHOW | 驅動程式應該會顯示重迭;也就是說，驅動程式應該開啟此重迭。 |
overlayFX
指定 DirectDraw SDK 檔中描述的 DDOVERLAYFX 結構 (，) 說明驅動程式應該用來更新重迭的其他效果。 只有在 dwFlags 成員中設定了其中一個DDOVER_DDFX、DDOVER_KEYDESTOVERRIDE或DDOVER_KEYSRCOVERRIDE時，驅動程式才應該使用此結構。
ddRVal
指定驅動程式寫入 DdUpdateOverlay 回呼傳回值的位置。 DD_OK的傳回碼表示成功。 如需詳細資訊，請參閱 DirectDraw 的傳回值。
UpdateOverlay
由 DirectDraw API 使用，且不應由驅動程式填入。
需求
| 標頭 | ddrawint.h (包含 Winddi.h) |