Funzione NtGdiDdDestroySurface

  • Articolo

[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