D3D10CreateDevice-Funktion (d3d10misc.h)

Artikel
08/22/2023

Erstellen Sie ein Direct3D 10.0-Gerät, das die Grafikkarte darstellt.

Syntax

HRESULT D3D10CreateDevice(
  [in]  IDXGIAdapter      *pAdapter,
  [in]  D3D10_DRIVER_TYPE DriverType,
  [in]  HMODULE           Software,
  [in]  UINT              Flags,
  [in]  UINT              SDKVersion,
  [out] ID3D10Device      **ppDevice
);

Parameter

[in] pAdapter

Typ: IDXGIAdapter*

Zeiger auf den Anzeigeadapter (siehe IDXGIAdapter) 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 EnumAdapters aufgezählt wird.

[in] DriverType

Typ: D3D10_DRIVER_TYPE

Der Gerätetreibertyp (siehe D3D10_DRIVER_TYPE). Der Treibertyp bestimmt den Typ des Geräts, das Sie erstellen.

[in] Software

Typ: HMODULE

Reserviert. Auf NULL festgelegt.

[in] Flags

Typ: UINT

Optional. Geräteerstellungsflags (siehe D3D10_CREATE_DEVICE_FLAG), die API-Ebenen aktivieren. Diese Flags können zusammen bitweise OR'd sein.

[in] SDKVersion

Typ: UINT

Bitflag, das die Version des SDK angibt. Sollte immer D3D10_SDK_VERSION sein.

[out] ppDevice

Typ: ID3D10Device**

Adresse eines Zeigers auf das erstellte Gerät (siehe ID3D10Geräteschnittstelle).

Rückgabewert

Typ: HRESULT

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

Hinweise

In diesem Beispiel wird ein Referenzgerät erstellt.


ID3D10Device* g_pd3dDevice = NULL;
D3D10CreateDevice( NULL, D3D10_DRIVER_TYPE_REFERENCE, NULL, 0, 
    D3D10_SDK_VERSION, &g_pd3dDevice );

Informationen zum gleichzeitigen Erstellen eines Geräts und einer Swapchain finden Sie unter D3D10CreateDeviceAndSwapChain.

Das von D3D10CreateDevice zurückgegebene Objekt implementiert die IUnknown-Schnittstelle und kann nach anderen Schnittstellen abgefragt werden, die das Objekt unterstützt. Um die IDXGIDevice-Schnittstelle des Objekts abzurufen, kann der folgende Code verwendet werden.


IDXGIDevice * pDXGIDevice;
hr = g_pd3dDevice->QueryInterface(__uuidof(IDXGIDevice), (void **)&pDXGIDevice);

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	d3d10misc.h
Bibliothek	D3D10.lib
DLL	D3D10.dll

Weitere Informationen

Kernfunktionen

Freigeben über