PFND3DDDI_CREATEDEVICE Rückruffunktion (d3dumddi.h)

  • Artikel

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)

Weitere Informationen

D3DDDIARG_CREATEDEVICE

D3DDDI_ADAPTERFUNCS

DestroyDevice