IDXGISwapChain::GetBuffer-Methode (dxgi.h)

Greift auf einen der Hintergrundpuffer der Swapchain zu.

Syntax

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

Die Parameter

Buffer

Typ: UINT

Ein nullbasierter Pufferindex.

Wenn der Swapchain-Swapeffekt DXGI_SWAP_EFFECT_DISCARD ist, kann diese Methode nur auf den ersten Puffer zugreifen. für diese Situation legen Sie den Index auf Null fest.

Wenn der Swapchain-Swapeffekt entweder DXGI_SWAP_EFFECT_SEQUENTIAL ist, kann nur der Nullindexpuffer der Swapchain ausgelesen und in diese geschrieben werden. Die Swapchainpuffer mit Indizes größer als 0 können nur gelesen werden; Wenn Sie also die IDXGIResource::GetUsage-Methode für solche Puffer aufrufen, verfügen sie über den DXGI_USAGE_READ_ONLY Flagsatz.

Wenn der Swapchain-Swapeffekt DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL ist, ist die Beziehung zwischen Indizes und Puffern konsistent. Das Ergebnis ist identisch, wenn Sie den Nullindexpuffer der Swapchain nach jedem Aufruf von IDXGISwapChain::P resent abrufen. Ein richtiger Frameindex sollte zum Abrufen des aktuellen Backbuffers verwendet werden.

[in] riid

Typ: REFIID

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

[out] ppSurface

Typ: void**

Ein Zeiger auf eine Hintergrundpufferschnittstelle.

Rückgabewert

Typ: HRESULT

Gibt einen der folgenden DXGI_ERROR zurück.

Anforderungen

Siehe auch

IDXGISwapChain