Funzione DdCreateSurfaceObject (ddrawgdi.h)
[Questa funzione è soggetta a modifiche con ogni revisione del sistema operativo. Usare invece Microsoft DirectDraw e Microsoft Direct3DAPIs; queste API isolano le applicazioni da tali modifiche al sistema operativo e nascondono molte altre difficoltà nell'interagire direttamente con i driver di visualizzazione.
Wrapper per la funzione NtGdiDdCreateSurfaceObject e crea un oggetto superficie in modalità kernel.
GdiEntry4 è definito come alias per questa funzione.
Sintassi
BOOL DdCreateSurfaceObject(
LPDDRAWI_DDRAWSURFACE_LCL pSurfaceLocal,
BOOL bPrimarySurface
);
Parametri
pSurfaceLocal
Puntatore all'oggetto superficie in modalità utente. Per informazioni dettagliate, vedere la documentazione di DDK. Un handle per l'oggetto in modalità kernel viene inserito in pSurfaceLocal-hDDSurface>.
bPrimarySurface
Riservato.
Valore restituito
In caso di esito positivo, questa funzione restituisce TRUE; in caso contrario restituisce FALSE.
Commenti
Questa funzione viene usata per creare oggetti che rappresentano superfici di memoria di sistema. Alle superfici di memoria video viene assegnata una rappresentazione in modalità kernel come parte implicita della chiamata NtGdiDdCreateSurfaceObject .
Le applicazioni sono consigliate di usare le API DirectDraw e Direct3D per creare e gestire oggetti dispositivo grafico. Questi costrutti astraggono il processo di creazione del dispositivo in modo semplificato e indipendente dal sistema operativo.
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | ddrawgdi.h |