IDXGISwapChain::GetBuffer-Methode (dxgi.h)

Greift auf einen der Backpuffer der Swapkette zu.

Syntax

HRESULT GetBuffer(
        UINT   Buffer,
  [in]  REFIID riid,
  [out] void   **ppSurface
);

Parameter

Buffer

Typ: UINT

Ein nullbasierter Pufferindex.

Wenn der Swap chain-Effekt DXGI_SWAP_EFFECT_DISCARD ist, kann diese Methode nur auf den ersten Puffer zugreifen. Legen Sie für diese Situation den Index auf 0 fest.

Wenn der Swap chain-Effekt entweder DXGI_SWAP_EFFECT_SEQUENTIAL oder DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL ist, kann nur der Nullindexpuffer der Swapchain gelesen und in geschrieben werden. Puffer der Swapchain mit Indizes größer 0 können nur ausgelesen werden. Wenn Sie also die IDXGIResource::GetUsage-Methode für solche Puffer aufrufen, haben sie das DXGI_USAGE_READ_ONLY-Flag festgelegt.

[in] riid

Typ: REFIID

Der Typ der Schnittstelle, die zum Bearbeiten des Puffers verwendet wird.

[out] ppSurface

Typ: void**

Ein Zeiger auf eine Backpufferschnittstelle.

Rückgabewert

Typ: HRESULT

Gibt eine der folgenden DXGI_ERROR zurück.

Anforderungen

Weitere Informationen

IDXGISwapChain