> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PIXGpuCaptureNextFrame (família XBOX One)

> Captura o próximo quadro de dados da GPU.

Captura o próximo quadro de dados da GPU.

<a id="syntaxSection" />

## Sintaxe

```cpp theme={null}
HRESULT PIXGpuCaptureNextFrame(  
         UINT Flags,  
         LPCWSTR lpOutputFileName  
)  
```

<a id="parametersSection" />

### Parâmetros

*Flags*   \_In\_\
Tipo: UINT

Os sinalizadores para controlar esta captura de GPU do PIX, como uma combinação OR bit a bit de constantes de enumeração [D3D12XBOX\_PIX\_CAPTURE\_FLAGS](/pt-BR/reference/graphics/d3d12_x/enums/d3d12xbox_pix_capture_flags).

*lpOutputFileName*   \_In\_z\_\
Tipo: LPCWSTR

O nome do arquivo no qual armazenar os dados.

<a id="retvalSection" />

### Valor retornado

Tipo: HRESULT

Um dos [códigos de retorno do Direct3D 12](https://msdn.microsoft.com/library/windows/desktop/dn706075\(v=vs.85\).aspx).

<a id="remarksSection" />

## Comentários

Esta função executa uma captura de GPU do PIX na qual o próximo quadro único é capturado em um arquivo no console para análise posterior, sem a necessidade de chamar [PIXGpuBeginCapture](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12commandqueue/methods/id3d12commandqueue_pixgpubegincapture) ou [PIXGpuEndCapture](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12commandqueue/methods/id3d12commandqueue_pixgpuendcapture). Os dados capturados por esta função são armazenados como um arquivo .xpix no console. Você deve copiar o arquivo para o seu PC de desenvolvimento antes da análise. Para obter mais informações sobre capturas de GPU do PIX, confira [Capturas de GPU do PIX](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/tools-console/xbox-tools-and-apis/pix/gpu/pix-gpu-capture).

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** d3d12\_x.h

**Biblioteca:** d3d12\_x.lib

**Plataformas com suporte:** família XBOX One

<a id="seealsoSection" />

## Confira também

[ID3D12CommandQueue](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12commandqueue/id3d12commandqueue)\
[d3d12\_x](/pt-BR/reference/graphics/d3d12_x/d3d12_x_members)


## Related topics

- [PIX GPU Trace captures on XBOX Series consoles](/tools/tools-console/pix/gpu-trace/index.md)
- [XAppCaptureVideoCaptureSettings](/es/reference/system/xappcapture/structs/xappcapturevideocapturesettings.md)
- [PIXCaptureParameters](/es/reference/tools/pix3/structs/pixcaptureparameters.md)
- [PIX GPU capture and performance analysis](/tools/tools-console/pix/gpu/index.md)
- [XAppCaptureGetVideoCaptureSettings](/es/reference/system/xappcapture/functions/xappcapturegetvideocapturesettings.md)