> ## 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.

# PIXGetCaptureState

> PIXGetCaptureState

# PIXGetCaptureState

Recupera o tipo de capturas em andamento, como um conjunto de sinalizadores.

## Sintaxe

```cpp theme={null}
DWORD PIXGetCaptureState(  
)  
```

### Parâmetros

### Valor retornado

Tipo: DWORD

Sinalizadores de estado de captura. Se nenhum sinalizador de estado de captura estiver definido, zero será retornado, o que indica que o PIX não tem capturas em andamento.

#### Sinalizadores

| Sinalizador | Valor | Descrição |
| - | - | - |
| PIX\_CAPTURE\_TIMING | (1 \<\< 0) | Tempo do sistema. |
| PIX\_CAPTURE\_GPU | (1 \<\< 1) | Captura todos os comandos e suas entradas enviados à GPU para que possam ser reproduzidos e analisados. |
| PIX\_CAPTURE\_FUNCTION\_SUMMARY | (1 \<\< 2) | Uma captura de resumo de funções foi iniciada na guia **Home**. |
| PIX\_CAPTURE\_FUNCTION\_DETAILS | (1 \<\< 3) | Uma solicitação de detalhes adicionais de funções foi iniciada usando o botão **Capture Additional Calls** em uma captura de resumo de funções ou de grafo de chamadas. |
| PIX\_CAPTURE\_CALLGRAPH | (1 \<\< 4) | Uma captura de grafo de chamadas foi iniciada no PIX ou programaticamente chamando `PIXBeginCapture`. |
| PIX\_CAPTURE\_INSTRUCTION\_TRACE | (1 \<\< 5) | Uma captura de rastreamento de instruções da CPU está em andamento. |
| PIX\_CAPTURE\_SYSTEM\_MONITOR\_COUNTERS | (1 \<\< 6) | Contadores do monitor do sistema. |
| PIX\_CAPTURE\_VIDEO | (1 \<\< 7) | Reprodução de vídeo. |
| PIX\_CAPTURE\_AUDIO | (1 \<\< 8) | Reprodução de áudio. |
| PIX\_CAPTURE\_GPU\_TRACE | (1 \<\< 9) | Captura contadores do GPU Streaming Performance Monitor (SPM) e dados de Shader Queue Thread Tracing (SQTT) de quase todos os blocos da GPU. |
| PIX\_CAPTURE\_RESERVED | (1 \<\< 15) | Sinalizador de espaço reservado usado internamente pelo PIX para cenários de captura futuros ou especializados. |

## Comentários

Os sinalizadores recuperados de `PIXCaptureState` são usados como parâmetros na função [PIXBeginCapture](/pt-BR/reference/tools/pix3/functions/pixbegincapture).
No caso de [PIXBeginCapture](/pt-BR/reference/tools/pix3/functions/pixbegincapture), o sinalizador determinará qual tipo de captura do PIX é iniciado.
Você pode confirmar que a captura foi iniciada corretamente chamando esta função para verificar os tipos de captura que estão em execução no momento.

## Requisitos

**Cabeçalho:** pix3.h

**Biblioteca:** pixevt.lib

**Plataformas compatíveis:** consoles da família XBOX One e consoles XBOX Series

## Confira também

[PIXBeginCapture](/pt-BR/reference/tools/pix3/functions/pixbegincapture)\
[PIX3](/pt-BR/reference/tools/pix3/pix3_members)\
[PIX (tópico sob NDA)](/pt-BR/tools/tools-console/pix/pix)


## Related topics

- [PIX3](/pt-BR/reference/tools/pix3/pix3_members.md)
- [PIXCaptureParameters](/pt-BR/reference/tools/pix3/structs/pixcaptureparameters.md)
- [CreateCaptureAudioStateMonitor](/pt-BR/reference/audio/audiostatemonitor/functions/createcaptureaudiostatemonitor.md)
- [XAppCaptureMetadataStopState](/pt-BR/reference/system/xappcapture/functions/xappcapturemetadatastopstate.md)
- [CreateCaptureAudioStateMonitorForCategory](/pt-BR/reference/audio/audiostatemonitor/functions/createcaptureaudiostatemonitorforcategory.md)