NtGdiDdGetDC fonction)
[Cette fonction est sujette à modification avec 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 contexte de périphérique (DC) pour la surface spécifiée.
Syntaxe
HDC APIENTRY NtGdiDdGetDC(
_In_ HANDLE hSurface,
_In_ PALETTEENTRY *puColorTable
);
Paramètres
-
hSurface [ dans]
-
Handle vers une surface DirectDraw en mode noyau précédemment retournée par NtGdiDdCreateSurface ou NtGdiDdCreateSurfaceObject.
-
puColorTable [ dans]
-
Pointeur vers une table de couleurs de remplacement pour le contrôleur de périphérique retourné.
Valeur retournée
En cas de réussite, cette fonction retourne un HDC valide ; Sinon, elle retourne la valeur null.
Remarques
Un seul contrôleur de périphérique est autorisé par surface à un moment donné. Les appels suivants à NtGdiDdGetDC échouent tant que le DC précédent n’est pas libéré.
Il est recommandé aux applications d’appeler IDirectDrawSurface7 :: GetDC à la place, ce qui fournit les mêmes fonctionnalités d’une manière indépendante du système d’exploitation.
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] |
| En-tête |
|