Funzione NtGdiDdCreateSurfaceObject

Articolo
06/13/2023

[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.

Crea un oggetto superficie in modalità kernel che rappresenta l'oggetto superficie in modalità utente a cui fa riferimento puSurfaceLocal.

Sintassi

HANDLE APIENTRY NtGdiDdCreateSurfaceObject(
  _In_ HANDLE             hDirectDrawLocal,
  _In_ HANDLE             hSurface,
  _In_ PDD_SURFACE_LOCAL  puSurfaceLocal,
  _In_ PDD_SURFACE_MORE   puSurfaceMore,
  _In_ PDD_SURFACE_GLOBAL puSurfaceGlobal,
  _In_ BOOL               bComplete
);

Parametri

hDirectDrawLocal [in]: Handle per l'oggetto DirectDraw in modalità kernel.
hSurface [in]: Handle precedente alla stessa superficie. Utilizzato se la superficie viene ricreata dopo un cambio di modalità.
puSurfaceLocal [in]: Puntatore alla struttura DD_SURFACE_LOCAL che rappresenta l'oggetto superficie in modalità utente DirectDraw con cui associare la memoria allocata. Per informazioni dettagliate, vedere la documentazione di DDK.
puSurfaceMore [in]: Puntatore alla struttura DD_SURFACE_MORE che contiene dati locali aggiuntivi per ogni singolo oggetto superficie. Per informazioni dettagliate, vedere la documentazione di DDK.
puSurfaceGlobal [in]: Puntatore alla struttura DD_SURFACE_GLOBAL che contiene i dati della superficie condivisi a livello globale con più superfici. Per informazioni dettagliate, vedere la documentazione di DDK.
bComplete [in]: Flag di completamento dell'oggetto in modalità kernel. Può essere uno dei valori seguenti.
(TRUE): Completare tutte le elaborazioni relative alla rappresentazione in modalità kernel.
(FALSE): Creare l'oggetto, ma non configurare dati interni, ad esempio il puntatore alla memoria. Gli oggetti creati con FALSE possono essere collegati tramite NtGdiDdAttachSurface e vengono completati da una chiamata a NtGdiDdCreateSurface.

Valore restituito

In caso di esito positivo, questa funzione restituisce un handle alla rappresentazione della superficie in modalità kernel; in caso contrario restituisce NULL.

Commenti

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

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Ntgdi.h

Vedi anche

Supporto client grafica di basso livello
DdCreateSurfaceObject
NtGdiDdDeleteSurfaceObject
NtGdiDdAttachSurface
NtGdiDdCreateSurface