Funzione NtGdiDdCreateD3DBuffer

Articolo
06/03/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.

Usato per creare un comando a livello di driver o un vertex buffer della descrizione specificata.

Sintassi

DWORD APIENTRY NtGdiDdCreateD3DBuffer(
  _In_    HANDLE               hDirectDraw,
  _Inout_ HANDLE               *hSurface,
  _Inout_ DDSURFACEDESC        *puSurfaceDescription,
  _Inout_ DD_SURFACE_GLOBAL    *puSurfaceGlobalData,
  _Inout_ DD_SURFACE_LOCAL     *puSurfaceLocalData,
  _Inout_ DD_SURFACE_MORE      *puSurfaceMoreData,
  _Inout_ DD_CREATESURFACEDATA *puCreateSurfaceData,
  _Inout_ HANDLE               *puhSurface
);

Parametri

hDirectDraw [in]: Handle per la struttura DD_DIRECTDRAW_GLOBAL che rappresenta il driver.
hSurface [in, out]: Puntatore a una matrice di handle di superficie. Il chiamante può impostare questi handle sui valori di handle precedenti se le superfici vengono ricreate dopo un cambio di modalità. Questo processo è denominato "ripristino" nella documentazione di DirectDraw.
puSurfaceDescription [in, out]: Puntatore a una struttura DDSURFACEDESC che descrive la superficie o il buffer che il driver deve creare.
puSurfaceGlobalData [in, out]: Puntatore a una struttura DD_SURFACE_GLOBAL contenente dati di superficie condivisi a livello globale con più superfici.
puSurfaceLocalData [in, out]: Puntatore a un elenco di strutture DD_SURFACE_LOCAL che descrivono gli oggetti superficie creati dal driver. In genere è presente una sola voce in questa matrice.
puSurfaceMoreData [in, out]: Puntatore a una struttura DD_SURFACE_MORE che contiene dati aggiuntivi sulla superficie locale.
puCreateSurfaceData [in, out]: Puntatore a una struttura DD_CREATESURFACEDATA contenente le informazioni necessarie per creare il buffer.
puhSurface [in, out]: Viene usato dall'API DirectDraw e non deve essere compilato dal driver.

Valore restituito

NtGdiDdCreateD3DBuffer restituisce uno dei codici di callback seguenti.

Codice restituito	Descrizione
DDHAL_DRIVER_HANDLED	Il driver ha eseguito l'operazione e ha restituito un codice restituito valido per tale operazione. Se questo codice è DD_OK, DirectDraw o Direct3D procede con la funzione . In caso contrario, DirectDraw o Direct3D restituisce il codice di errore fornito dal driver e interrompe la funzione.
DDHAL_DRIVER_NOTHANDLED	Il driver non ha alcun commento sull'operazione richiesta. Se è necessario che il driver abbia implementato un callback specifico, DirectDraw o Direct3D segnala una condizione di errore. In caso contrario, DirectDraw o Direct3D gestisce l'operazione come se il callback del driver non fosse stato definito eseguendo l'implementazione indipendente dal dispositivo DirectDraw o Direct3D.

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