NtGdiDdDestroySurface fonction)
[Cette fonction est sujette à modification avec chaque révision du système d’exploitation. Utilisez à la place DirectDraw et Microsoft Direct3DAPIs ; Ces API isolent les applications de ces modifications du système d’exploitation et masquent de nombreuses autres difficultés liées à l’interaction directe avec les pilotes d’affichage.]
Détruit un objet surface Microsoft DirectDraw précédemment alloué en mode noyau.
Syntaxe
DWORD APIENTRY NtGdiDdDestroySurface(
_In_ HANDLE hSurface,
_In_ BOOL bRealDestroy
);
Paramètres
-
hSurface [ dans]
-
Handle vers l’objet surface en mode noyau précédemment alloué.
-
bRealDestroy [ dans]
-
Spécifie comment détruire l’aire. Il peut s’agir de l’une des valeurs suivantes.
-
:
-
Détruisez la surface et la mémoire vidéo libre.
-
FAUSSES
-
Libérez de la mémoire vidéo tout en laissant la surface dans un État non initialisé.
Valeur retournée
NtGdiDdDestroySurface retourne l’un des codes de rappel suivants.
| Code de retour | Description |
|---|---|
|
Le pilote a effectué l’opération et a retourné un code de retour valide pour cette opération. Si ce code est JJ _ OK, DirectDraw ou Direct3D continue avec la fonction. Dans le cas contraire, DirectDraw ou Direct3D retourne le code d’erreur fourni par le pilote et abandonne la fonction. |
|
Le pilote n’a pas de commentaire sur l’opération demandée. Si le pilote doit avoir implémenté un rappel particulier, DirectDraw ou Direct3D signale une condition d’erreur. Dans le cas contraire, DirectDraw ou Direct3D gère l’opération comme si le rappel de pilote n’avait pas été défini par l’exécution de l’implémentation de DirectDraw ou de l’implémentation indépendante du périphérique Direct3D. |
Remarques
Il est recommandé que les applications utilisent les API DirectDraw et Direct3D pour créer et détruire des surfaces au lieu de cette fonction.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows 2000 Professionnel - [Applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows 2000 Server - [Applications de bureau uniquement] |
| En-tête |
|