PFND3DDDI_CREATEDEVICE Rückruffunktion (d3dumddi.h)
Die CreateDevice--Funktion erstellt einen Grafikkontext, auf den in nachfolgenden Aufrufen verwiesen wird.
Syntax
PFND3DDDI_CREATEDEVICE Pfnd3dddiCreatedevice;
HRESULT Pfnd3dddiCreatedevice(
HANDLE hAdapter,
D3DDDIARG_CREATEDEVICE *unnamedParam2
)
{...}
Parameter
hAdapter
Ein Handle, das den Grafikadapter identifiziert.
unnamedParam2
pCreateData- [in, out]
Ein Zeiger auf eine D3DDDIARG_CREATEDEVICE Struktur. Bei der Eingabe enthält diese Struktur Informationen, die der Treiber verwenden kann. Bei der Ausgabe gibt der Treiber Informationen in der Struktur an, die von der Microsoft Direct3D-Laufzeit verwendet werden kann.
Rückgabewert
CreateDevice gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | Der Grafikkontext wurde erfolgreich erstellt. |
| E_OUTOFMEMORY | CreateDevice- konnte den speicher, der für den Abschluss erforderlich war, nicht zuordnen. |
Bemerkungen
Ein Anzeigegerät ist ein Grafikkontext, der verwendet wird, um eine Sammlung des Renderingzustands zu enthalten. Mehrere Geräte können von demselben Prozess auf einem bestimmten Adapter erstellt werden. Beachten Sie, dass die Anzahl der Anzeigegeräte, die gleichzeitig vorhanden sein können, nur durch den verfügbaren Systemspeicher begrenzt ist. Das heißt, ein Treiber kann kein maximales Gerätelimit hartcodieren.
Im Allgemeinen sind Geräte unabhängig voneinander, sodass ressourcen, die auf einem Gerät erstellt werden, nicht durch Ressourcen verwiesen oder darauf zugegriffen werden kann, die in einer anderen erstellt werden. Prozessübergreifende Ressourcen sind jedoch eine Ausnahme von dieser Regel.
Wenn die Direct3D-Laufzeit CreateDevice- aufruft, um ein Gerät zu erstellen, erstellt die Laufzeit keinen Standardkontextthread der Grafikverarbeitungseinheit (GPU) der Ausführung für das Gerät. Der Treiber muss die pfnCreateContextCb--Funktion explizit aufrufen, um einen oder mehrere Kontexte nach Bedarf zu erstellen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform- | Desktop |
| Header- | d3dumddi.h (include D3dumddi.h) |