Fonction DdGetDC (ddrawgdi.h)

[Cette fonction est susceptible d’être modifiée à chaque révision du système d’exploitation. Utilisez plutôt DirectDraw et Microsoft Direct3DAPIs ; ces API isolent les applications de tels changements de système d’exploitation et masquent de nombreuses autres difficultés liées à l’interaction directe avec les pilotes d’affichage.]

Wrapper pour la fonction NtGdiDdGetDC et retourne un contexte d’appareil Windows Graphics Device Interface (DC) qui représente la surface Microsoft DirectDraw indiquée.

GdiEntry7 est défini comme alias pour cette fonction.

Syntaxe

HDC DdGetDC(
  LPDDRAWI_DDRAWSURFACE_LCL pSurfaceLocal,
  LPPALETTEENTRY            pColorTable
);

Paramètres

pSurfaceLocal

Pointeur vers la surface DirectDraw pour laquelle un contrôleur de domaine est demandé.

pColorTable

Pointeur facultatif vers un tableau de 256 entrées de structures PALETTEENTRY . Si la table de couleurs est null et que le mode surface et affichage sont tous deux de 8 bits par pixel, le contrôleur de domaine partage la table de couleurs de l’appareil.

Valeur retournée

Si elle réussit, cette fonction retourne un HDC valide ; sinon, il retourne NULL.

Remarques

Si la surface et le mode d’affichage actuel sont palettisés à 8 bits par pixel, le contrôleur de domaine peut recevoir la propriété spéciale selon laquelle sa table de couleurs est partagée par la table de couleurs de l’appareil d’affichage. Il est conseillé aux applications d’appeler IDirectDrawSurface7 ::GetDC à la place, qui fournit les mêmes fonctionnalités d’une manière indépendante du système d’exploitation.

Le contrôleur de domaine retourné doit être libéré par un appel à NtGdiDdReleaseDC ou GdiEntry8.

Configuration requise

Voir aussi

Prise en charge du client graphique de bas niveau