Funzione DrvDeriveSurface (winddi.h)
La funzione DrvDeriveSurface deriva una superficie GDI dall'area DirectDraw specificata.
Sintassi
HBITMAP DrvDeriveSurface(
DD_DIRECTDRAW_GLOBAL *pDirectDraw,
DD_SURFACE_LOCAL *pSurface
);
Parametri
pDirectDraw
Puntatore a una struttura DD_DIRECTDRAW_GLOBAL che descrive l'oggetto DirectDraw.
pSurface
Puntatore a una struttura DD_SURFACE_LOCAL che descrive la superficie DirectDraw intorno alla quale eseguire il wrapping di una superficie GDI.
Valore restituito
DrvDeriveSurface restituisce un handle alla superficie GDI derivata al successo. Restituisce NULL se la chiamata ha esito negativo o se il driver non può accelerare il disegno GDI nell'area DirectDraw specificata.
Commenti
DrvDeriveSurface consente al driver di creare una superficie GDI avvolta attorno a un oggetto di superficie DirectDraw o AGP per consentire il disegno GDI accelerato sulla superficie. Se il driver non collega questa chiamata, tutti i disegni GDI sulle superfici DirectDraw vengono eseguiti nel software usando il motore DIB.
GDI chiama DrvDeriveSurface solo con superfici RGB.
Il driver deve chiamare DrvCreateDeviceBitmap per creare una superficie GDI della stessa dimensione e formato della superficie DirectDraw. Lo spazio per i pixel effettivi non deve essere allocato poiché esiste già.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | winddi.h (include Winddi.h) |