NtGdiDdUnattachSurface fonction)

[Cette fonction est sujette à modification avec chaque révision du système d’exploitation. Utilisez plutôt Microsoft 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.]

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 [ dans]

Objet surface en mode noyau qui a été passé en tant que paramètre hSurfaceFrom à NtGdiDdAttachSurface.

hSurfaceAttached [ dans]

Objet surface en mode noyau qui a été passé en tant que paramètre hSurfaceTo à NtGdiDdAttachSurface

Valeur retournée

NtGdiDdUnattachSurface retourne l’un des codes de rappel suivants.

Code de retour Description
_pilote DDHAL _ géré
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.
DDHAL de _ pilote _ NOTHANDLED
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.

Notes

Il est recommandé que les applications utilisent l’API DirectDraw, qui gère les pièces jointes de surface de manière plus détaillé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é.

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
Ntgdi. h

Voir aussi

Prise en charge des clients de bas niveau