DdGetDxHandle-Funktion (ddrawgdi.h)

  • Artikel

[Diese Funktion kann sich mit jeder Betriebssystemrevision ändern. Verwenden Sie stattdessen die Microsoft DirectDraw- und Microsoft Direct3DAPIs. diese APIs isolieren Anwendungen vor solchen Betriebssystemänderungen und verbergen viele andere Schwierigkeiten, 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.

GdiEntry14 ist als Alias für diese Funktion definiert.

Syntax

HANDLE DdGetDxHandle(
  [in] LPDDRAWI_DIRECTDRAW_LCL   pDDraw,
  [in] LPDDRAWI_DDRAWSURFACE_LCL pSurface,
  [in] BOOL                      bRelease
);

Parameter

[in] pDDraw

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

[in] pSurface

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

[in] bRelease

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 pDDraw als auch pSurface angegeben werden, wird pSurface ignoriert.

Anforderungen

   
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

Siehe auch

Low-Level-Clientunterstützung für Grafiken