NtGdiDdCreateSurfaceObject 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.]

Crée un objet surface en mode noyau qui représente l’objet surface en mode utilisateur référencé par puSurfaceLocal.

Syntaxe

HANDLE APIENTRY NtGdiDdCreateSurfaceObject(
  _In_ HANDLE             hDirectDrawLocal,
  _In_ HANDLE             hSurface,
  _In_ PDD_SURFACE_LOCAL  puSurfaceLocal,
  _In_ PDD_SURFACE_MORE   puSurfaceMore,
  _In_ PDD_SURFACE_GLOBAL puSurfaceGlobal,
  _In_ BOOL               bComplete
);

Paramètres

hDirectDrawLocal [ dans]

Handle vers l’objet DirectDraw en mode noyau.

hSurface [ dans]

Handle précédent à la même surface. Utilisé si la surface est recréée après un basculement de mode.

puSurfaceLocal [ dans]

Pointeur vers la structure de _ surface _ locale DD qui représente l’objet de surface de mode utilisateur DirectDraw avec lequel associer la mémoire allouée. Pour plus d’informations, consultez la documentation du DDK.

puSurfaceMore [ dans]

Pointeur vers la structure de _ _ plus de surface DD qui contient des données locales supplémentaires pour chaque objet surface individuel. Pour plus d’informations, consultez la documentation du DDK.

puSurfaceGlobal [ dans]

Pointeur vers la structure _ _ globale de la surface DD qui contient les données de surface partagées globalement avec plusieurs surfaces. Pour plus d’informations, consultez la documentation du DDK.

bComplete [ dans]

Indicateur de fin de l’objet en mode noyau. Il peut s’agir de l’une des valeurs suivantes.

:

Terminez tout le traitement concernant la représentation en mode noyau.

FAUSSES

Créez l’objet, mais ne configurez pas de données internes telles que le pointeur de mémoire. Les objets créés à l’aide de la valeur false peuvent être joints à l’aide de NtGdiDdAttachSurface et sont terminés par un appel à NtGdiDdCreateSurface.

Valeur retournée

En cas de réussite, cette fonction retourne un handle vers la représentation sous forme de surface en mode noyau. Sinon, elle retourne la valeur null.

Remarques

Il est recommandé aux applications d’utiliser les API DirectDraw et Direct3D pour créer et gérer des objets d’appareils graphiques. Ces constructions résument le processus de création d’appareils de façon simplifiée et indépendante du système d’exploitation.

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

DdCreateSurfaceObject

NtGdiDdDeleteSurfaceObject

NtGdiDdAttachSurface

NtGdiDdCreateSurface