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

Vedi anche

Supporto client grafica di basso livello