PFND3D10DDI_CREATEDEVICE Rückruffunktion (d3d10umddi.h)

  • Artikel

Die CreateDevice(D3D10) -Funktion erstellt einen Grafikkontext, auf den in nachfolgenden Aufrufen verwiesen wird.

Syntax

PFND3D10DDI_CREATEDEVICE Pfnd3d10ddiCreatedevice;

HRESULT Pfnd3d10ddiCreatedevice(
  D3D10DDI_HADAPTER unnamedParam1,
  D3D10DDIARG_CREATEDEVICE *unnamedParam2
)
{...}

Parameter

unnamedParam1

hAdapter [in]

Ein Handle für das Grafikadapterobjekt, das mit der OpenAdapter10-Funktion erstellt wurde.

unnamedParam2

pCreateData [in, out]

Ein Zeiger auf eine D3D10DDIARG_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(D3D10) gibt einen der folgenden Werte zurück:

Rückgabecode Beschreibung
S_OK Der Grafikkontext wurde erfolgreich erstellt.
DXGI_STATUS_NO_REDIRECTION Der Grafikkontext wurde erfolgreich erstellt. Die DirectX-Grafikinfrastruktur (DXGI) sollte jedoch nicht den freigegebenen Ressourcenpräsentationspfad verwenden, um die Kommunikation mit dem Desktop-Windows Manager (DWM) zu bewirken. Weitere Informationen zum DXGI DDI finden Sie unter Unterstützen von DXGI DDI.
E_OUTOFMEMORY CreateDevice(D3D10) konnte den für den Abschluss erforderlichen Arbeitsspeicher nicht zuordnen.

Hinweise

Ein Anzeigegerät ist ein Grafikkontext, der verwendet wird, um eine Sammlung des Renderingzustands zu enthalten. Derselbe Prozess kann mehrere Geräte auf einem bestimmten Adapter erstellen. Beachten Sie, dass die Anzahl von Anzeigegeräten, 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 von Ressourcen, die in einem anderen erstellt werden, verwiesen oder darauf zugegriffen werden kann. Prozessübergreifende Ressourcen sind jedoch eine Ausnahme von dieser Regel.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform Desktop
Kopfzeile d3d10umddi.h (include D3d10umddi.h)

Weitere Informationen

D3D10DDIARG_CREATEDEVICE

D3D10DDI_ADAPTERFUNCS

DestroyDevice(D3D10)

OpenAdapter10