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 |
|