NtGdiDdGetDxHandle-Funktion

  • Artikel

[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.]

Gibt das Microsoft DirectX-API-Handle im Kernelmodus zurück, das in nachfolgenden Aufrufen der Kernelmodus-Einstiegspunkte verwendet werden soll, die den DirectX-API-Mechanismus steuern.

Syntax

DWORD APIENTRY NtGdiDdGetDxHandle(
  _In_ HANDLE hDirectDraw,
  _In_ HANDLE hSurface,
  _In_ BOOL   bRelease
);

Parameter

hDirectDraw [in]

Handle zum DirectDraw-Objekt, das die Oberfläche besitzt. Dieser Parameter ist optional und kann auf NULL festgelegt werden.

hSurface [in]

Handle für Surface, für die ein DirectX-API-Handle im Kernelmodus zurückgegeben werden soll. Dieser Parameter ist optional und kann auf NULL festgelegt werden.

bRelease [in]

Legen Sie auf TRUE fest, wenn die Kernelmodusschnittstelle der DirectX-API freigegeben werden soll. Andernfalls FALSE.

Rückgabewert

Ein DirectX-API-Handle, das in nachfolgenden DirectX-API-orientierten Kerneleinstiegspunkten verwendet wird.

Bemerkungen

Wenn sowohl hDirectDraw als auch hSurface angegeben sind, wird hSurface ignoriert.

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