Fonction NtGdiDdUnattachSurface
[Cette fonction est susceptible d’être modifiée à chaque révision du système d’exploitation. Utilisez plutôt Microsoft DirectDraw et Microsoft Direct3DAPIs ; ces API isolent les applications de tels changements de système d’exploitation et masquent de nombreuses autres difficultés liées à l’interaction directe avec les pilotes d’affichage.]
Supprime une pièce jointe, créée avec NtGdiDdAttachSurface, entre deux objets surface en mode noyau.
Syntaxe
VOID APIENTRY NtGdiDdUnattachSurface(
_In_ HANDLE hSurface,
_In_ HANDLE hSurfaceAttached
);
Paramètres
-
hSurface [in]
-
Objet surface en mode noyau passé en tant que paramètre hSurfaceFrom à NtGdiDdAttachSurface.
-
hSurfaceAttached [in]
-
Objet surface en mode noyau passé en tant que paramètre hSurfaceTo à NtGdiDdAttachSurface
Valeur retournée
NtGdiDdUnattachSurface retourne l’un des codes de rappel suivants.
| Code de retour | Description |
|---|---|
|
Le pilote a effectué l’opération et retourné un code de retour valide pour cette opération. Si ce code est DD_OK, DirectDraw ou Direct3D poursuit avec la fonction . Sinon, DirectDraw ou Direct3D retourne le code d’erreur fourni par le pilote et abandonne la fonction. |
|
Le pilote n’a aucun 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. Sinon, DirectDraw ou Direct3D gère l’opération comme si le rappel du pilote n’avait pas été défini en exécutant l’implémentation indépendante de l’appareil DirectDraw ou Direct3D. |
Notes
Il est recommandé aux applications d’utiliser l’API DirectDraw, qui gère les pièces jointes de surface de manière plus élevée.
Il n’est pas nécessaire d’appeler cette fonction, car le noyau détruit automatiquement toutes les pièces jointes lorsque NtGdiDdDestroySurface est appelé.
Spécifications
| 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 |
|
Voir aussi