IDirect3DDevice9Ex::CreateOffscreenPlainSurfaceEx-Methode (d3d9.h)

Erstellen Sie eine Off-Screen-Oberfläche.

Syntax

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

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.

[in] Usage

Typ: DWORD

Kombination einer oder mehrerer D3DUSAGE-Konstanten , die zusammen OR'd sein können. Der Wert 0 gibt an, dass keine Verwendung verwendet wird.

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 wie eine Oberfläche aufweist, die mit der CreateImageSurface-Methode von DirectX 8.x 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-Einfache Oberflächen sind immer absperrbar, unabhängig von ihren Pooltypen.

Anforderungen

Weitere Informationen

IDirect3DDevice9Ex