NtGdiDdGetDC-Funktion

Artikel
06/13/2023

[Diese Funktion kann sich bei jeder Betriebssystemrevision ändern. Verwenden Sie stattdessen Microsoft 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.]

Erstellt einen Gerätekontext (Device Context, DC) für die angegebene Oberfläche.

Syntax

HDC APIENTRY NtGdiDdGetDC(
  _In_ HANDLE       hSurface,
  _In_ PALETTEENTRY *puColorTable
);

Parameter

hSurface [in]: Handle für eine DirectDraw-Oberfläche im Kernelmodus, die zuvor von NtGdiDdCreateSurface oder NtGdiDdCreateSurfaceObject zurückgegeben wurde.
puColorTable [in]: Zeiger auf eine Überschreibungsfarbtabelle für den zurückgegebenen DC.

Rückgabewert

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

Bemerkungen

Pro Oberfläche ist zu einem bestimmten Zeitpunkt nur ein DC zulässig. Nachfolgende Aufrufe von NtGdiDdGetDC schlagen fehl, bis der vorherige DC freigegeben wurde.

Anwendungen wird empfohlen, stattdessen IDirectDrawSurface7::GetDC aufzurufen, wodurch die gleiche Funktionalität unabhängig vom Betriebssystem bereitgestellt wird.

Anforderungen

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

Siehe auch

Unterstützung des Grafikclients auf niedriger Ebene
DdGetDC

Freigeben über