Método IDXGISwapChain::GetBuffer (dxgi.h)

Acessa um dos buffers de fundo da cadeia de troca.

Sintaxe

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

Parâmetros

Buffer

Tipo: UINT

Um índice de buffer baseado em zero.

Se o efeito de troca da cadeia de troca for DXGI_SWAP_EFFECT_DISCARD, esse método só poderá acessar o primeiro buffer; para essa situação, defina o índice como zero.

Se o efeito de troca da cadeia de troca for DXGI_SWAP_EFFECT_SEQUENTIAL, somente o buffer de índice zero da cadeia de troca poderá ser lido e gravado. Os buffers da cadeia de troca com índices maiores que zero só podem ser lidos; portanto, se você chamar o método IDXGIResource::GetUsage para esses buffers, eles terão o sinalizador DXGI_USAGE_READ_ONLY definido.

Se o efeito de troca da cadeia de troca for DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL, a relação entre índices e buffers será consistente. O resultado será idêntico se você receber o buffer de índice zero da cadeia de troca após cada vez que IDXGISwapChain::P resent for chamado. Um índice de quadro correto deve ser usado para recuperar o backbuffer atual.

[in] riid

Tipo: REFIID

O tipo de interface usado para manipular o buffer.

[out] ppSurface

Tipo: void**

Um ponteiro para uma interface de buffer de fundo.

Valor de retorno

Tipo: HRESULT

Retorna um dos DXGI_ERROR a seguir.

Requirements

Consulte também

IDXGISwapChain