Funzione NtGdiDdUnattachSurface

Articolo
06/12/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à coinvolte nell'interagire direttamente con i driver di visualizzazione.

Rimuove un allegato, creato con NtGdiDdAttachSurface, tra due oggetti surface in modalità kernel.

Sintassi

VOID APIENTRY NtGdiDdUnattachSurface(
  _In_ HANDLE hSurface,
  _In_ HANDLE hSurfaceAttached
);

Parametri

hSurface [in]: Oggetto surface in modalità kernel passato come parametro hSurfaceFrom a NtGdiDdAttachSurface.
hSurfaceAttached [in]: Oggetto surface in modalità kernel passato come parametro hSurfaceTo a NtGdiDdAttachSurface

Valore restituito

NtGdiDdUnattachSurface 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 l'API DirectDraw, che gestisce gli allegati di superficie in modo superiore.

Non è necessario chiamare questa funzione perché il kernel eliminerà automaticamente tutti gli allegati quando viene chiamato NtGdiDestroySurface .

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