DdGetDxHandle-Funktion (ddrawgdi.h)
[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 |