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

Legt die Position für eine Überlagerung fest.

Syntax

DWORD APIENTRY NtGdiDdSetOverlayPosition(
  _In_    HANDLE                     hSurfaceSource,
  _In_    HANDLE                     hSurfaceDestination,
  _Inout_ PDD_SETOVERLAYPOSITIONDATA puSetOverlayPositionData
);

Parameter

hSurfaceSource [in]

Handle für eine DD_SURFACE_LOCAL Struktur, die die DirectDraw-Überlagerungsoberfläche darstellt.

hSurfaceDestination [in]

Zeiger auf eine DD_SURFACE_LOCAL Struktur, die die Oberfläche darstellt, die überlagert wird.

puSetOverlayPositionData [in, out]

Zeiger auf eine DD_SETOVERLAYPOSITIONDATA-Struktur , die die zum Festlegen der Überlagerungsposition erforderlichen Informationen enthält.

Rückgabewert

NtGdiDdSetOverlayPosition gibt einen der folgenden Rückrufcodes zurück.

Rückgabecode Beschreibung
DDHAL_DRIVER_HANDLED
 Der Treiber hat den Vorgang ausgeführt und einen gültigen Rückgabecode für diesen Vorgang zurückgegeben. Wenn dieser Code DD_OK ist, wird DirectDraw oder Direct3D mit der -Funktion fortgesetzt. Andernfalls gibt DirectDraw oder Direct3D den vom Treiber bereitgestellten Fehlercode zurück und bricht die Funktion ab.
DDHAL_DRIVER_NOTHANDLED
 Der Treiber hat keinen Kommentar zum angeforderten Vorgang. Wenn der Treiber einen bestimmten Rückruf implementiert haben muss, meldet DirectDraw oder Direct3D eine Fehlerbedingung. Andernfalls verarbeitet DirectDraw oder Direct3D den Vorgang so, als ob der Treiberrückruf nicht durch Ausführen der geräteunabhängigen DirectDraw- oder Direct3D-Implementierung definiert worden wäre.

 

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