PIXBeginCapture

Inicia uma captura de tempo do PIX controlada programaticamente.

Sintaxe

HRESULT PIXBeginCapture(  
         DWORD captureFlags,  
         const PPIXCaptureParameters captureParameters  
)  

Parâmetros

captureFlags
Tipo: DWORD Um sinalizador que indica o tipo de captura a ser realizada. Somente um sinalizador de captura pode ser passado para PIXBeginCapture por vez. captureParameters _In_opt_
Tipo: PPIXCaptureParameters Para capturas de tempo, passe um ponteiro para a estrutura TimingCaptureParameters ou passe um ponteiro para a união PIXCaptureParameters, que contém a estrutura TimingCaptureParameters.

Valor retornado

Tipo: HRESULT Indica se a captura foi iniciada com êxito. S_FALSE é retornado em caso de êxito. Somente uma captura pode estar em execução por vez. Se PIXBeginCapture for chamado enquanto outra captura estiver em execução, E_PENDING será retornado e a chamada não terá efeito.

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 pelo 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 SPM (Streaming Performance Monitor) da GPU e dados de SQTT (Shader Queue Thread Tracing) 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

Esta função inicia uma captura do PIX a partir do código do título. Atualmente, PIXBeginCapture só pode ser usado para fazer uma captura de tempo (tópico sob NDA). PIXBeginCapture armazena os dados da captura na memória de ferramentas do console. A quantidade de memória de ferramentas disponibilizada para a captura é especificada definindo o campo MaximumToolingMemorySizeMb na estrutura PIXCaptureParameters. As capturas de tempo programáticas podem ser feitas em um de dois modos, conforme definido pelo valor da enumeração PIXCaptureStorage na estrutura PIXCaptureParameters. Quando PIXCaptureStorage é definido como Memory, PIXBeginCapture preencherá a memória de ferramentas disponibilizada e, em seguida, descartará todos os novos dados recebidos. Quando PIXCaptureStorage é definido como MemoryCircular, PIXBeginCapture usará a memória de ferramentas como um buffer circular. A captura será executada até que a memória de ferramentas esteja cheia, mas, em vez de interromper a captura, os dados mais antigos serão descartados para abrir espaço para novos dados. A captura continuará em execução. As capturas MemoryCircular foram projetadas para serem executadas por longos períodos sem esgotar a memória de ferramentas disponível no console. As capturas de tempo feitas usando PIXBeginCapture devem ser copiadas de volta para o PC e convertidas em um arquivo .xpix antes de poderem ser exibidas no PIX. Confira Abrindo capturas de tempo programáticas (tópico sob NDA) para obter uma descrição das etapas necessárias para exibir uma captura programática no PIX. Use PIXEndCapture para interromper uma captura do PIX a partir do código do título.

//
//  timing capture
//
PIXCaptureParameters captureParams = {};

captureParams.TimingCaptureParameters.CaptureGpuTiming = TRUE;
captureParams.TimingCaptureParameters.CaptureCallstacks = TRUE;
captureParams.TimingCaptureParameters.CaptureCpuSamples = TRUE;
captureParams.TimingCaptureParameters.CpuSamplesPerSecond = 4000;

captureParams.TimingCaptureParameters.CaptureStorage = PIXCaptureParameters::Memory;
captureParams.TimingCaptureParameters.FileName = wstrFilename;
captureParams.TimingCaptureParameters.MaximumToolingMemorySizeMb = 4096;

XSF_ERROR_IF_FAILED(PIXBeginCapture(PIX_CAPTURE_TIMING, &captureParams));

Requisitos

Cabeçalho: pix3.h Biblioteca: pixevt.lib Plataformas com suporte: consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Análise do desempenho da CPU (conteúdo)

Confira também

PIXEndCapture
PIXCaptureParameters
PIX3
PIX (tópico sob NDA)

Porting

Build Paths

PIXBeginCapture

PIXBeginCapture

Sintaxe

Parâmetros

Valor retornado

Sinalizadores

Comentários

Requisitos

Documentação conceitual

Confira também

​PIXBeginCapture

​Sintaxe

​Parâmetros

​Valor retornado

​Sinalizadores

​Comentários

​Requisitos

​Documentação conceitual

​Confira também

PIXBeginCapture

Sintaxe

Parâmetros

Valor retornado

Sinalizadores

Comentários

Requisitos

Documentação conceitual

Confira também