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 Grafikkarten identifiziert.
unnamedParam2
pCreateData [ein, aus]
Ein Zeiger auf eine D3DDDIARG_CREATEDEVICE-Struktur . Bei der Eingabe enthält diese Struktur Informationen, die der Treiber verwenden kann. In der Ausgabe gibt der Treiber Informationen in der Struktur an, die die Microsoft Direct3D-Runtime verwenden 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 nicht zuordnen, der für die Vervollständigung erforderlich war. |
Hinweise
Ein Anzeigegerät ist ein Grafikkontext, der verwendet wird, um eine Auflistung des Renderingzustands zu enthalten. Mehrere Geräte können mit 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 ein maximales Gerätelimit nicht hartcodieren.
Im Allgemeinen sind Geräte unabhängig voneinander, sodass auf Ressourcen, die auf einem Gerät erstellt werden, nicht referenziert oder von Ressourcen zugegriffen werden kann, die in einem anderen erstellt werden. Prozessübergreifende Ressourcen sind jedoch eine Ausnahme von dieser Regel.
Wenn die Direct3D-Runtime CreateDevice aufruft , um ein Gerät zu erstellen, erstellt die Runtime keinen STANDARDMÄßIGen GPU-Kontextthread für die Ausführung des Geräts. Der Treiber muss explizit die PfnCreateContextCb-Funktion aufrufen, um nach Bedarf einen oder mehrere Kontexte zu erstellen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform | Desktop |
| Kopfzeile | d3dumddi.h (include D3dumddi.h) |