NtGdiDdCreateSurfaceEx-Funktion
[Diese Funktion kann bei jeder Betriebssystemrevision geändert werden. Verwenden Sie stattdessen DirectDraw und Direct3DAPIs. Diese APIs isolieren Anwendungen vor solchen Betriebssystemänderungen und verbergen viele andere Schwierigkeiten bei der direkten Interaktion mit Anzeigetreibern.]
Erstellt eine Microsoft Direct3D-Oberfläche aus einer Microsoft DirectDraw-Oberfläche und ordnet ihr einen angeforderten Handlewert zu.
Syntax
DWORD APIENTRY NtGdiDdCreateSurfaceEx(
_In_ HANDLE hDirectDraw,
_In_ HANDLE hSurface,
_In_ DWORD dwSurfaceHandle
);
Parameter
-
hDirectDraw [ In]
-
Handle für das DirectDraw-Objekt, das von der Anwendung erstellt wurde.
-
hSurface [ In]
-
Handle für die DirectDraw-Oberfläche, die für Direct3D erstellt werden soll. Diese Handles sind innerhalb der einzelnen DD _ DIRECTDRAW _ LOCAL-Strukturen eindeutig.
-
dwSurfaceHandle [ In]
-
Handle für eine DD _ CREATESURFACEEXDATA-Struktur, die die Informationen enthält, die der Treiber zum Erstellen der Oberfläche benötigt.
Rückgabewert
NtGdiDdCreateSurfaceEx gibt einen der folgenden Rückrufcodes zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
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. |
|
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 |
|