Fonction NtGdiDdFlip

Article
06/13/2023

[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 ces modifications du système d’exploitation et masquent de nombreuses autres difficultés liées à l’interaction directe avec les pilotes d’affichage.]

Provoque l’échange de la mémoire de surface associée aux surfaces cibles et actuelles.

Syntaxe

DWORD APIENTRY NtGdiDdFlip(
  _In_    HANDLE       hSurfaceCurrent,
  _In_    HANDLE       hSurfaceTarget,
  _In_    HANDLE       hSurfaceCurrentLeft,
  _In_    HANDLE       hSurfaceTargetLeft,
  _Inout_ PDD_FLIPDATA puFlipData
);

Paramètres

hSurfaceCurrent [in]: Handle à la structure DD_SURFACE_LOCAL décrivant la surface actuelle.
hSurfaceTarget [in]: Gérer à la structure DD_SURFACE_LOCAL décrivant la surface cible ; c’est-à-dire la surface vers laquelle le pilote doit basculer.
hSurfaceCurrentLeft [in]: Handle à la structure DD_SURFACE_LOCAL décrivant la surface gauche actuelle.
hSurfaceTargetLeft [in]: Handle to the DD_SURFACE_LOCAL structure décrivant la surface cible gauche vers laquelle basculer.
puFlipData [in, out]: Pointeur vers une structure de DD_FLIPDATA qui contient les informations requises pour effectuer le basculement.

Valeur retournée

NtGdiDdFlip retourne l’un des codes de rappel suivants.

Code de retour	Description
DDHAL_DRIVER_HANDLED	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 exécute la fonction . Sinon, DirectDraw ou Direct3D retourne le code d’erreur fourni par le pilote et abandonne la fonction.
DDHAL_DRIVER_NOTHANDLED	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 DirectDraw ou Direct3D indépendante du périphérique.

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

Voir aussi

Prise en charge du client de bas niveau graphique

Partager via