D3DX10CreateDevice-Funktion
Erstellen Sie das beste Direct3D 10-Gerät, das die Grafikkarte darstellt. Wenn ein Direct3D 10.1-kompatibles Gerät erstellt werden kann, ist es möglich, einen ID3D10Device1-Schnittstellenzeiger aus dem 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 Anzeigeadapter (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 aufgezä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 abzurufen, rufen Sie die GetModuleHandle-Funktion auf.
-
Flaggen [in]
-
Typ: UINT
Geräteerstellungsflags (siehe D3D10_CREATE_DEVICE_FLAG Enumeration), die API-Ebenen aktivieren. Diese Flags können bitweise ODER zusammen sein.
-
ppDevice [out]
-
Typ: ID3D10Geräte**
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.
Bemerkungen
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 kein Gerät 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:
- Verwenden Sie die D3D10CreateDevice-Funktion , um nur ein Direct3D 10.0-Gerät zu erstellen.
- Verwenden Sie die D3D10CreateDevice1-Funktion , um nur ein Direct3D 10.1-Gerät zu erstellen.
- Verwenden Sie die D3DX10GetFeatureLevel1-Funktion , um einen ID3D10Device1-Schnittstellenzeiger aus einem ID3D10Device-Schnittstellenzeiger abzurufen.
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 aufzurufen, auf denen eine beliebige Windows-Version ausgeführt wird, auf der die D3DX10-DLL installiert ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
Siehe auch