D3DX10CreateDevice-Funktion

Erstellen Sie das beste Direct3D 10-Gerät, das den Adapter darstellt. Wenn ein Direct3D 10.1-kompatibles Gerät erstellt werden kann, ist es möglich, einen ID3D10Device1-Schnittstellenzeiger vom zurückgegebenen Geräteschnittstellenzeiger zu erhalten.

Syntax

HRESULT D3DX10CreateDevice(
  _In_  IDXGIAdapter      *pAdapter,
  _In_  D3D10_DRIVER_TYPE DriverType,
  _In_  HMODULE           Software,
  _In_  UINT              Flags,
  _Out_ ID3D10Device      **ppDevice
);

Parameter

pAdapter [ In]

Typ: IDXGIAdapter*

Zeiger auf den Adapter (siehe IDXGIAdapter-Schnittstelle) beim Erstellen eines Hardwaregeräts; Legen Sie andernfalls diesen Parameter auf NULL fest. Wenn BEIM Erstellen eines Hardwaregeräts NULL angegeben wird, verwendet Direct3D den ersten Adapter, der von der IDXGIFactory-Schnittstelle aufzählt wird.

DriverType [ In]

Typ: D3D10 _ DRIVER _ TYPE

Der Gerätetreibertyp (siehe D3D10 _ DRIVER _ TYPE-Enumeration). Der Treibertyp bestimmt den Typ des Geräts, das Sie erstellen.

Software [ In]

Typ: HMODULE

Ein Handle für ein geladenes Modul, das einen Softwaretreiber implementiert (z. B. D3D10Ref.dll). Um ein Handle zu erhalten, rufen Sie die GetModuleHandle-Funktion auf.

Flags [ In]

Typ: UINT

Geräteerstellungsflags (siehe D3D10 _ CREATE _ DEVICE _ FLAG-Enumeration), die API-Ebenen aktivieren. Diese Flags können bitweise OR'd zusammen sein.

ppDevice [ out]

Typ: ID3D10Device**

Adresse eines Zeigers auf das erstellte Gerät (siehe ID3D10Device-Schnittstelle).

Rückgabewert

Typ: HRESULT

Diese Funktion gibt einen der folgenden Direct3D 10-Rückgabecodes zurück.

Hinweise

Diese Funktion versucht, das beste Gerät für die Hardware zu erstellen. Zunächst versucht die Funktion, ein 10.1-Gerät zu erstellen. Wenn ein 10.1-Gerät nicht erstellt werden kann, versucht die Funktion, ein 10.0-Gerät zu erstellen. Wenn keines der beiden Geräte erfolgreich erstellt wurde, gibt die Funktion E _ FAIL zurück.

Wenn Ihre Anwendung nur ein 10.1-Gerät oder nur ein 10.0-Gerät erstellen muss, verwenden Sie stattdessen die folgenden Funktionen:

Ein Direct3D 10.1-Gerät kann nur auf Computern mit Windows Vista Service Pack 1 oder höher und mit installierter Direct3D 10.1-kompatibler Hardware erstellt werden. Es ist jedoch legal, diese Funktion auf Computern auf einem beliebigen Computer auf Windows, auf dem die D3DX10-DLL installiert ist.

Anforderungen

Anforderung Wert
Header
D3DX10Core.h

Weitere Informationen

Universell Functions