IDirect3DDevice9::CreateOffscreenPlainSurface-Methode (d3d9helper.h)

  • Artikel

Erstellen Sie eine Off-Screen-Oberfläche.

Syntax

HRESULT CreateOffscreenPlainSurface(
  [in]          UINT              Width,
  [in]          UINT              Height,
  [in]          D3DFORMAT         Format,
  [in]          D3DPOOL           Pool,
  [out, retval] IDirect3DSurface9 **ppSurface,
  [in]          HANDLE            *pSharedHandle
);

Parameter

[in] Width

Typ: UINT

Breite der Oberfläche.

[in] Height

Typ: UINT

Höhe der Oberfläche.

[in] Format

Typ: D3DFORMAT

Format der Oberfläche. Siehe D3DFORMAT.

[in] Pool

Typ: D3DPOOL

Surface-Pooltyp. Siehe D3DPOOL.

[out, retval] ppSurface

Typ: IDirect3DSurface9**

Zeiger auf die erstellte IDirect3DSurface9-Schnittstelle .

[in] pSharedHandle

Typ: HANDLE*

Reserviert. Legen Sie diesen Parameter auf NULL fest. Dieser Parameter kann in Direct3D 9 für Windows Vista zum Freigeben von Ressourcen verwendet werden.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Methode fehlschlägt, kann der Rückgabewert wie folgt aussehen: D3DERR_INVALIDCALL.

Hinweise

D3DPOOL_SCRATCH gibt eine Oberfläche zurück, die identische Eigenschaften mit einer Oberfläche aufweist, die mit der DirectX 8.x-Methode CreateImageSurface erstellt wurde.

D3DPOOL_DEFAULT ist der geeignete Pool für die Verwendung mit IDirect3DDevice9::StretchRect und IDirect3DDevice9::ColorFill.

D3DPOOL_MANAGED ist nicht zulässig, wenn eine einfache Oberfläche außerhalb des Bildschirms erstellt wird. Weitere Informationen zu Speicherpools finden Sie unter D3DPOOL.

Off-Screen-Plain-Oberflächen können immer gesperrt werden, unabhängig von ihren Pooltypen.

Anforderungen

   
Zielplattform Windows
Kopfzeile d3d9helper.h (einschließlich D3D9.h)
Bibliothek D3D9.lib

Weitere Informationen

IDirect3DDevice9