Funzione NtGdiD3DContextCreate

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

Sintassi

BOOL APIENTRY NtGdiD3DContextCreate(
  _In_    HANDLE                  hDirectDrawLocal,
  _In_    HANDLE                  hSurfColor,
  _In_    HANDLE                  hSurfZ,
  _Inout_ D3DNTHAL_CONTEXTCREATEI *pdcci
);

Parametri

hDirectDrawLocal [in]: Gestire in un oggetto DirectDraw in modalità kernel, creato in precedenza con NtGdiDdCreateDirectDrawObject, che rappresenta il dispositivo in cui deve essere creato il contesto Direct3D.
hSurfColor [in]: Handle in una struttura DD_SURFACE_LOCAL che descrive la superficie DirectDraw da usare come destinazione di rendering.
hSurfZ [in]: Handle in una struttura DD_SURFACE_LOCAL che descrive la superficie DirectDraw da usare come buffer di profondità. Se questo membro è NULL, non deve essere eseguito alcun buffer di profondità.
pdcci [in, out]: Puntatore a una struttura D3DNTHAL_CONTEXTCREATEDATA che contiene le informazioni necessarie per creare un contesto e i dati che il driver deve archiviare nel nuovo contesto.

Valore restituito

NtGdiD3DContextCreate 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

Condividi tramite