D3DX10CreateDeviceAndSwapChain-Funktion

Artikel
06/12/2023

Erstellen Sie das beste Direct3D-Gerät und eine Swapchain.

Syntax

HRESULT D3DX10CreateDeviceAndSwapChain(
  _In_  IDXGIAdapter         *pAdapter,
  _In_  D3D10_DRIVER_TYPE    DriverType,
  _In_  HMODULE              Software,
  _In_  UINT                 Flags,
  _In_  DXGI_SWAP_CHAIN_DESC *pSwapChainDesc,
  _Out_ IDXGISwapChain       **ppSwapChain,
  _Out_ ID3D10Device         **ppDevice
);

Parameter

pAdapter [in]

Typ: IDXGIAdapter*

Zeiger auf einen IDXGIAdapter.

DriverType [in]

Typ: D3D10_DRIVER_TYPE

Der Typ des Treibers für das Gerät. Siehe D3D10_DRIVER_TYPE.

Software [in]

Typ: HMODULE

Ein Handle für die DLL, das einen Softwarerasterer implementiert. Muss NULL sein, wenn DriverType keine Software ist. Das HMODULE einer DLL kann mit LoadLibrary, LoadLibraryEx oder GetModuleHandle abgerufen werden.

Flaggen [in]

Typ: UINT

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

pSwapChainDesc [in]

Typ: DXGI_SWAP_CHAIN_DESC*

Beschreibung der Swapchain. Siehe DXGI_SWAP_CHAIN_DESC.

ppSwapChain [out]

Typ: IDXGISwapChain**

Adresse eines Zeigers auf eine IDXGISwapChain.

ppDevice [out]

Typ: ID3D10Device**

Adresse eines Zeigers auf eine ID3D10Geräteschnittstelle , die das neu erstellte Gerät empfängt.

Rückgabewert

Typ: HRESULT

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

Bemerkungen

Um das beste Gerät zu erstellen, implementiert diese Methode mehrere Geräteerstellungsoption. Zunächst versucht die -Methode, ein 10.1-Gerät (und eine Swapchain) zu erstellen. Wenn dies fehlschlägt, versucht die -Methode, ein 10.0-Gerät zu erstellen. Wenn dies fehlschlägt, schlägt die Methode fehl. Wenn Ihre Anwendung nur ein 10.1-Gerät oder nur ein 10.0-Gerät erstellen muss, verwenden Sie stattdessen die folgenden APIs:

Verwenden Sie D3D10CreateDeviceAndSwapChain , um ein Direct3D 10.0-Gerät (nur) und eine Swapchain zu erstellen.
Verwenden Sie D3D10CreateDeviceAndSwapChain1 , um ein Direct3D 10.1-Gerät und eine Swapchain zu erstellen.

Für diese Methode ist Windows Vista Service Pack 1 erforderlich.

Anforderungen

Anforderung	Wert
Header	D3DX10Core.h

Siehe auch

Universell-Funktionen

Freigeben über