DD_UPDATEOVERLAYDATA struttura (ddrawint.h)
La struttura DD_UPDATEOVERLAYDATA contiene informazioni necessarie per aggiornare una superficie di sovrapposizione.
Sintassi
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;
Members
lpDD
Punta a una struttura DD_DIRECTDRAW_GLOBAL che descrive il dispositivo del driver.
lpDDDestSurface
Punta a una struttura di DD_SURFACE_LOCAL che rappresenta la superficie Microsoft DirectDraw da sovraserire. Questo valore può essere NULL se DDOVER_HIDE è specificato in dwFlags.
rDest
Specifica una struttura RECTL che contiene le dimensioni x, y, larghezza e altezza dell'area nell'area di destinazione da sovralicciare.
lpDDSrcSurface
Punta a una struttura DD_SURFACE_LOCAL che descrive la superficie di sovrapposizione.
rSrc
Specifica una struttura RECTL che contiene la proprietà x, y, larghezza e altezza dell'area nell'area di origine da utilizzare per la sovrapposizione.
dwFlags
Specifica come il driver deve gestire la sovrapposizione. Questo membro può essere una combinazione di uno dei flag seguenti:
| Flag | Significato |
|---|---|
| DDOVER_ADDDIRTYRECT | Deve essere ignorato dal driver. |
| DDOVER_AUTOFLIP | Il driver deve eseguire automaticamente l'sovrimpressione ogni volta che la porta video hardware si adatta automaticamente. I driver che supportano le estensioni della porta video (VPE) devono controllare solo questo flag. |
| DDOVER_BOB | Il driver deve visualizzare ogni campo dei dati dell'oggetto VPE singolarmente senza causare alcun artefatto jittery. Questo flag riguarda sia VPE che decodificatori che vogliono eseguire il proprio capovolgimento in modalità kernel usando la funzionalità di trasporto video in modalità kernel. |
| DDOVER_BOBHARDWARE | Indica che bob viene eseguito dall'hardware anziché dal software o dall'emulazione. I driver che supportano VPE devono controllare solo questo flag. |
| DDOVER_DDFX | Il driver deve visualizzare la superficie di sovrapposizione usando gli attributi specificati dal membro overlayFX . |
| DDOVER_HIDE | Il driver deve nascondere la sovrapposizione; ovvero, il driver deve disattivare questa sovrapposizione. |
| DDOVER_INTERLEAVED | La superficie di sovrapposizione è costituita da campi interleaved. I driver che supportano VPE devono controllare solo questo flag. |
| DDOVER_KEYDEST | Il driver deve usare la chiave di colore associata all'area di destinazione. |
| DDOVER_KEYDESTOVERRIDE | Il driver deve usare il membro dckDestColorKey della struttura DDOVERLAYFX (descritto nella documentazione di DirectDraw SDK) come chiave di colore di destinazione anziché la chiave di colore associata all'area di destinazione. |
| DDOVER_KEYSRC | Il driver deve usare la chiave di colore associata all'area di destinazione. |
| DDOVER_KEYSRCOVERRIDE | Il driver deve usare il membro dckSrcColorKey della struttura DDOVERLAYFX (descritto nella documentazione di DirectDraw SDK) come chiave colore di origine anziché la chiave di colore associata all'area di destinazione. |
| DDOVER_OVERRIDEBOBWEAVE | Le decisioni bob/weave non devono essere sostituite da altre interfacce. Se il mixer di sovrapposizione imposta questo flag, DirectDraw non consente a un driver in modalità kernel di usare la funzionalità di trasporto video in modalità kernel per cambiare l'hardware tra bob e modalità weave. |
| DDOVER_REFRESHALL | Deve essere ignorato dal driver. |
| DDOVER_REFRESHDIRTYRECTS | Deve essere ignorato dal driver. |
| DDOVER_SHOW | Il driver deve mostrare la sovrapposizione; ovvero, il driver deve attivare questa sovrapposizione. |
overlayFX
Specifica una struttura DDOVERLAYFX (descritta nella documentazione di DirectDraw SDK) che descrive gli effetti aggiuntivi che il driver deve usare per aggiornare la sovrapposizione. Il driver deve usare questa struttura solo se uno dei DDOVER_DDFX, DDOVER_KEYDESTOVERRIDE o DDOVER_KEYSRCOVERRIDE sono impostati nel membro dwFlags .
ddRVal
Specifica il percorso in cui il driver scrive il valore restituito del callback DdUpdateOverlay . Un codice restituito di DD_OK indica l'esito positivo. Per altre informazioni, vedere Restituire valori per DirectDraw.
UpdateOverlay
Usato dall'API DirectDraw e non deve essere compilato dal driver.
Requisiti
| Intestazione | ddrawint.h (include Winddi.h) |