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
Ntgdi. h

Voir aussi

Prise en charge des clients de bas niveau

DdGetDC