Prise en charge du client Graphics Low-Level

[Ces fonctions sont susceptibles de changer avec chaque révision du système d’exploitation. Utilisez plutôt les api Microsoft DirectDraw et Microsoft Direct3DAPIs ; ces API isolent les applications de ces changements de système d’exploitation et masquent de nombreuses autres difficultés liées à l’interaction directe avec les pilotes d’affichage. Pour plus d’informations, consultez Présentation de l’affichage.]

DirectDraw et Direct3D utilisent certaines routines en mode noyau pour communiquer avec le système d’exploitation et le pilote d’affichage.

Le noyau du système d’exploitation semble être un pilote d’affichage DirectDraw/Direct3D du point de vue des composants en mode utilisateur. Toutefois, certaines différences entre le noyau et les pilotes d’affichage existent. Les composants en mode noyau conservent une copie de structures représentant des objets DirectDraw/Direct3D, tels que des appareils et des surfaces. Le composant en mode utilisateur de DirectDraw/Direct3D demande la création de ces structures, qui sont référencées avec des handles retournés par le mode noyau. Par conséquent, les différences sont principalement dans les arguments passés aux routines : le noyau accepte les handles tandis que les pilotes acceptent généralement des pointeurs.

• évolution des points d’entrée en mode noyau
• appeler le du noyau
• écriture d’applications portables
• de création d’appareil
• objets noyau
• Functions
• rubriques connexes

Évolution des points d’entrée en mode noyau

DirectDraw établit toutes ses connexions au mode noyau via le Gdi32.dll à l’aide de plusieurs points d’entrée. Ces points d’entrée ne marshalent généralement que les paramètres. Dans le cadre de la création de l’appareil, le Gdi32.dll retourne des pointeurs vers des routines qui sont ensuite utilisées par DirectDraw et Direct3D 7.0.

Direct3D 8.x effectue un saut propre de Gdi32.dllet appelle directement les points d’entrée en mode noyau.

Appel du noyau

Ces points d’entrée sont similaires et, dans de nombreux cas, identiques aux points d’entrée dans le pilote d’affichage lui-même, donc une compréhension des matériaux du Kit de développement de pilotes (DDK) pour DirectDraw et Direct3D est un prérequis essentiel à l’utilisation de ces fonctions.

L’appel de ces fonctions diffère entre les systèmes d’exploitation. Sur Windows 2000, le W2KUMODE. La bibliothèque LIB contient des routines qui permettent au thread appelant d’effectuer la transition vers le mode noyau. Ces routines n’effectuent aucun marshaling de paramètres et sont le mécanisme d’appel idéal sur Windows 2000. Le mécanisme qui effectue la transition vers le mode noyau repose sur l’ordre d’une table. Ce classement changera entre les révisions du système d’exploitation. Par conséquent, il n’est pas recommandé de créer une application qui s’appuie sur W2KUMODE. LIB pour Windows 2000 et attendez-vous qu’il s’exécute sans modification sur Windows XP. Un mécanisme de création de portabilité du système d’exploitation est décrit dans la section suivante.

Sur Windows XP, D3D8THK.DLL exporte toutes les fonctions en mode noyau, mais avec un nom légèrement décoré. L’exemple suivant montre comment les applications peuvent alias les fonctions clientes de bas niveau à l’aide du préprocesseur. Avant de procéder ainsi, liez dynamiquement à D3D8THK.DLL.

#define NtGdiDdUnlock OsThunkDdUnlock
#include "ntgdi.h"      // Brings in the definition of "NtGdiDdUnlock", 
.                       //   which is now seen as OsThunkDdUnlock.
.
.
OsThunkDdUnlock(hSurface, puUnlockData);

Écriture d’applications portables

Plusieurs techniques sont disponibles pour rendre une application portable sur les systèmes d’exploitation. Le plus robuste consiste à installer le package redistribuable Microsoft DirectX 8.x sur Windows 2000 dans le cadre du processus d’installation de votre propre application. Cela garantit que D3D8THK.DLL sera disponible sur les systèmes Windows 2000 et autorise un chemin d’accès à code unique dans l’application, car vous pouvez utiliser la même technique que celle décrite pour Windows XP ci-dessus.

Les applications peuvent également créer leur propre DLL isolante et implémenter deux versions de cette DLL, une pour Windows 2000 à l’aide de la technique indiquée ci-dessus et une pour Windows XP qui utilise D3D8THK.DLL.

Création d’appareils

DirectDraw et Direct3D doivent d’abord créer une instance de l’abstraction du noyau de l’objet pilote. Dans Gdi32.dll et Ddraw.dll, cela est obtenu en appelant DdCreateDirectDrawObject, DdQueryDirectDrawObject et DdReenableDirectDrawObject. Dans Direct3D 8.x, cela est obtenu en appelant NtGdiDdCreateDirectDrawObject, NtGdiDdQueryDirectDrawObject et NtGdiDdReenableDirectDrawObject. Notez que les points d’entrée GdiEntry* sont simplement des marshallers pour les points d’entrée en mode noyau.

Après avoir appelé ces fonctions, un handle est retourné qui représente l’abstraction de l’objet noyau d’un appareil DirectDraw. Cet objet noyau représente une instance de pilote appartenant au pilote d’affichage. Ce handle peut être utilisé dans les appels suivants, tels que DdCreateSurfaceObject (ou NtGdiDdCreateSurfaceObject dans Direct3D 8.x) pour générer d’autres objets.

Objets noyau

Quelques points d’entrée sont utilisés pour gérer les représentations en mode noyau de certains objets. DdCreateSurfaceObject (ou NtGdiDDCreateSurfaceObject dans Direct3D 8.x) est un bon exemple. Ce point d’entrée crée un objet en mode noyau représentant un morceau de mémoire système. Le point d’entrée retourne un handle et ce handle peut être utilisé dans les appels de dessin suivants. Le noyau dérive un pointeur vers sa propre structure à partir de ces handles et transmet ce pointeur au pilote d’affichage, qui effectue ensuite l’opération.

Fonctions

Ce tableau répertorie les fonctions qui représentent les points d’entrée en mode noyau et les routines d’assistance en mode utilisateur dans Gdi32.dll qui encapsulent ces points d’entrée.

Rubriques connexes

commande et d’allocation de mémoire tampon de vertex

Présentation de l’affichage des