Fonction NtGdiDdCreateSurfaceObject
[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.]
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 [in]
-
Gérez l’objet DirectDraw en mode noyau.
-
hSurface [in]
-
Poignée précédente sur la même surface. Utilisé si la surface est recréé après un changement de mode.
-
puSurfaceLocal [in]
-
Pointeur vers la structure DD_SURFACE_LOCAL qui représente l’objet surface en mode utilisateur DirectDraw auquel associer la mémoire allouée. Pour plus d’informations, consultez la documentation DDK.
-
puSurfaceMore [in]
-
Pointeur vers la structure DD_SURFACE_MORE qui contient des données locales supplémentaires pour chaque objet surface individuel. Pour plus d’informations, consultez la documentation DDK.
-
puSurfaceGlobal [in]
-
Pointeur vers la structure DD_SURFACE_GLOBAL qui contient des données de surface partagées globalement avec plusieurs surfaces. Pour plus d’informations, consultez la documentation DDK.
-
bComplete [in]
-
Indicateur d’achèvement d’objet en mode noyau. Il peut s’agir de l’une des valeurs suivantes.
-
(TRUE)
-
Terminez tout le traitement concernant la représentation en mode noyau.
-
(FALSE)
-
Créez l’objet, mais ne configurez pas les données internes telles que le pointeur de mémoire. Les objets créés à l’aide de FALSE peuvent être attachés à l’aide de NtGdiDdAttachSurface et sont complétés par un appel à NtGdiDdCreateSurface.
Valeur retournée
Si elle réussit, cette fonction retourne un handle à la représentation de surface en mode noyau ; sinon, elle retourne LA VALEUR NULL.
Notes
Il est recommandé aux applications d’utiliser les API DirectDraw et Direct3D pour créer et gérer des objets d’appareil graphique. Ces constructions abstraites du processus de création d’appareil de manière simplifiée et indépendante du système d’exploitation.
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 |
|
Voir aussi