Funzione NtGdiDdDestroySurface

Articolo
06/12/2023

[Questa funzione è soggetta a modifiche con ogni revisione del sistema operativo. Usare invece DirectDraw e Microsoft Direct3DAPIs; queste API isolano le applicazioni da tali modifiche al sistema operativo e nascondono molte altre difficoltà coinvolte nell'interagire direttamente con i driver di visualizzazione.

Elimina un oggetto surface Microsoft DirectDraw in modalità kernel allocato in precedenza.

Sintassi

DWORD APIENTRY NtGdiDdDestroySurface(
  _In_ HANDLE hSurface,
  _In_ BOOL   bRealDestroy
);

Parametri

hSurface [in]: Handle per l'oggetto surface in modalità kernel allocato in precedenza.
bRealDestroy [in]: Specifica come eliminare la superficie. Può essere uno dei valori seguenti.
(TRUE): Distruggere la superficie e liberare memoria video.
(FALSE): Liberare la memoria video ma lasciare la superficie in uno stato non inizializzato.

Valore restituito

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

Commenti

È consigliabile che le applicazioni usino le API DirectDraw e Direct3D per creare e distruggere le superfici anziché questa funzione.

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 a basso livello di grafica

Condividi tramite