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 |