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

Voir aussi

Prise en charge du client de bas niveau graphique

DdCreateSurfaceObject

NtGdiDdDeleteSurfaceObject

NtGdiDdAttachSurface

NtGdiDdCreateSurface