IDirect3D9Ex::CreateDeviceEx-Methode (d3d9.h)

  • Artikel

Erstellt ein Gerät, das die Grafikkarte darstellt.

Syntax

HRESULT CreateDeviceEx(
  [in]          UINT                  Adapter,
  [in]          D3DDEVTYPE            DeviceType,
  [in]          HWND                  hFocusWindow,
  [in]          DWORD                 BehaviorFlags,
  [in, out]     D3DPRESENT_PARAMETERS *pPresentationParameters,
  [in, out]     D3DDISPLAYMODEEX      *pFullscreenDisplayMode,
  [out, retval] IDirect3DDevice9Ex    **ppReturnedDeviceInterface
);

Parameter

[in] Adapter

Typ: UINT

Ordnungszahl, die die Grafikkarte angibt. D3DADAPTER_DEFAULT ist immer der primäre Grafikkarte.

[in] DeviceType

Typ: D3DDEVTYPE

Gibt den Typ des Geräts an. Siehe D3DDEVTYPE. Wenn der gewünschte Gerätetyp nicht verfügbar ist, schlägt die Methode fehl.

[in] hFocusWindow

Typ: HWND

Das Fokusfenster benachrichtigt Direct3D, wenn eine Anwendung vom Vordergrundmodus in den Hintergrundmodus wechselt. Für den Vollbildmodus muss das angegebene Fenster ein Fenster der obersten Ebene sein. Im Fenstermodus kann dieser Parameter nur NULL sein, wenn das hDeviceWindow-Element von pPresentationParameters auf einen gültigen Wert ungleich NULL festgelegt ist.

[in] BehaviorFlags

Typ: DWORD

Kombination einer oder mehrerer Optionen (siehe D3DCREATE), die die Geräteerstellung steuern.

[in, out] pPresentationParameters

Typ: D3DPRESENT_PARAMETERS*

Zeiger auf eine D3DPRESENT_PARAMETERS-Struktur , in der die Präsentationsparameter für das zu erstellende Gerät beschrieben werden. Wenn BehaviorFlagsD3DCREATE_ADAPTERGROUP_DEVICE angibt, ist dieser Parameter ein Array. Unabhängig von der Anzahl vorhandener Köpfe wird automatisch nur eine Tiefen-/Schablonenoberfläche erstellt.

Dieser Parameter ist sowohl ein Eingabe- als auch ein Ausgabeparameter. Das Aufrufen dieser Methode kann mehrere Member ändern, darunter:

  • Wenn BackBufferCount, BackBufferWidth und BackBufferHeight vor dem Aufruf der Methode 0 sind, werden sie geändert, wenn die Methode zurückgegeben wird.
  • Wenn BackBufferFormat gleich D3DFMT_UNKNOWN ist, bevor die Methode aufgerufen wird, wird es geändert, wenn die Methode zurückgegeben wird.

[in, out] pFullscreenDisplayMode

Typ: D3DDISPLAYMODEEX*

Der Anzeigemodus für, wenn das Gerät auf vollbildfestgelegt ist. Siehe D3DDISPLAYMODEEX. Wenn BehaviorFlagsD3DCREATE_ADAPTERGROUP_DEVICE angibt, ist dieser Parameter ein Array. Dieser Parameter muss für den Fenstermodus NULL sein.

[out, retval] ppReturnedDeviceInterface

Typ: IDirect3DDevice9Ex**

Adresse eines Zeigers auf den zurückgegebenen IDirect3DDevice9Ex, der das erstellte Gerät darstellt.

Rückgabewert

Typ: HRESULT

Diese Methode gibt S_OK zurück, wenn das Rendergerät zusammen mit Swapchainpuffern erfolgreich erstellt wurde. D3DERR_DEVICELOST wird zurückgegeben, wenn ein anderer Fehler als ungültige Aufrufereingaben auftritt.

Anforderungen

   
Zielplattform Windows
Kopfzeile d3d9.h
Bibliothek D3D9.lib

Weitere Informationen

IDirect3D9Ex