Fonction NtGdiDdCreateSurfaceEx

  • Article

[Cette fonction est susceptible d’être modifiée à chaque révision du système d’exploitation. Utilisez plutôt DirectDraw et 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.]

Crée une surface Microsoft Direct3D à partir d’une surface Microsoft DirectDraw et lui associe une valeur de handle demandée.

Syntaxe

DWORD APIENTRY NtGdiDdCreateSurfaceEx(
  _In_ HANDLE hDirectDraw,
  _In_ HANDLE hSurface,
  _In_ DWORD  dwSurfaceHandle
);

Paramètres

hDirectDraw [in]

Handle vers l’objet DirectDraw créé par l’application.

hSurface [in]

Handle vers la surface DirectDraw à créer pour Direct3D. Ces handles sont uniques au sein de chaque structure de DD_DIRECTDRAW_LOCAL .

dwSurfaceHandle [in]

Gérez vers une structure DD_CREATESURFACEEXDATA qui contient les informations requises pour que le pilote crée la surface.

Valeur retournée

NtGdiDdCreateSurfaceEx 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