DdGetDC-Funktion (ddrawgdi.h)

[Diese Funktion kann sich bei jeder Betriebssystemrevision ändern. Verwenden Sie stattdessen directDraw und Microsoft Direct3DAPIs. Diese APIs isolieren Anwendungen vor solchen Betriebssystemänderungen und blenden viele andere Probleme aus, die bei der direkten Interaktion mit Anzeigetreibern auftreten.]

Wrapper für die NtGdiDdGetDC-Funktion und gibt einen GDI-Gerätekontext (Windows Graphics Device Interface) zurück, der die angegebene Microsoft DirectDraw-Oberfläche darstellt.

GdiEntry7 ist als Alias für diese Funktion definiert.

Syntax

HDC DdGetDC(
  LPDDRAWI_DDRAWSURFACE_LCL pSurfaceLocal,
  LPPALETTEENTRY            pColorTable
);

Parameter

pSurfaceLocal

Zeiger auf die DirectDraw-Oberfläche, für die ein DC angefordert wird.

pColorTable

Optionaler Zeiger auf ein Array mit 256 Einträgen von PALETTEENTRY-Strukturen . Wenn die Farbtabelle NULL ist und die Oberfläche und der Anzeigemodus jeweils 8 Bit pro Pixel sind, teilt sich der DC die Farbtabelle des Geräts.

Rückgabewert

Bei erfolgreicher Ausführung gibt diese Funktion einen gültigen HDC zurück. Andernfalls wird NULL zurückgegeben.

Hinweise

Wenn sowohl die Oberfläche als auch der aktuelle Anzeigemodus mit 8 Bits pro Pixel palettiert werden, kann dem DC die spezielle Eigenschaft zugewiesen werden, dass seine Farbtabelle von der Farbtabelle des Anzeigegeräts gemeinsam genutzt wird. Anwendungen wird empfohlen, stattdessen IDirectDrawSurface7::GetDC aufzurufen, wodurch die gleiche Funktionalität unabhängig vom Betriebssystem bereitgestellt wird.

Der zurückgegebene DC muss durch einen Aufruf von NtGdiDdReleaseDC oder GdiEntry8 freigegeben werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ddrawgdi.h

Weitere Informationen

Unterstützung des Grafikclients auf niedriger Ebene