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
| 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] |
| Plateforme cible | Windows |
| En-tête | ddrawgdi.h |