Visão geral de PIXSetMarker
Insere um marcador na linha do tempo da GPU na janela PIX System Timing Capture quando ocorre um determinado evento definido pelo usuário.Sintaxe
Parâmetros
contextTipo: void* Contexto do evento; aceita ID3D12GraphicsCommandList* , ID3D12CommandQueue* e ID3D12XboxDmaCommandList* (somente XBOX). color
Tipo: UINT64 A cor que será usada no gráfico de tempo quando este evento ocorrer nas janelas do PIX. Use PIX_COLOR para especificar uma cor, use PIX_COLOR_INDEX para especificar um índice de cor ou passe um DWORD bruto, observando que o formato é ARGB e que o valor do canal alfa deve ser 0xff. formatString _In_
Tipo: PCWSTR O nome a ser usado para descrever o evento, como um ponteiro para uma cadeia de caracteres Unicode terminada em nulo. A cadeia de caracteres pode especificar zero ou mais espaços reservados de formato de cadeia de caracteres opcionais, muito semelhantes à formatação de sprintf. Tipo: … Se espaços reservados forem usados em formatString, deverá haver um número correspondente de parâmetros (até um máximo de 16) cujos tipos correspondam aos espaços reservados.
Valor retornado
Tipo: voidComentários
A funçãoPIXSetMarker salva a cadeia de caracteres de formato e os parâmetros de formato em vez de formatar a cadeia de caracteres em tempo de execução. A formatação é feita ao ler o arquivo de captura no PIX. Use cadeias de caracteres alinhadas a 16 bytes (preferível) ou alinhadas a 8 bytes com PIXSetMarker para obter o melhor desempenho. Para imprimir um char* ou wchar_t* como ponteiro usando o especificador de formato %p, converta o ponteiro para void* ou para um ponteiro de um tipo integral ou de ponto flutuante ao passá-lo para PIXSetMarker. Qualquer chamada a PIXSetMarker tem garantidos pelo menos 512 bytes de espaço para salvar os dados do registro.
O evento será mostrado sem duração e será representado por uma única linha (uma única barra vertical) na janela PIX System Timing Capture.
Esta função é usada para marcar eventos na linha do tempo da GPU. Para marcar eventos na linha do tempo da CPU, chame a primeira sobrecarga da função PIXSetMarker ou a segunda sobrecarga da função PIXSetMarker.
As chamadas a PIXSetMarker podem ocorrer em qualquer lugar e não precisam vir depois de uma chamada a PIXBeginEvent.
Requisitos
Cabeçalho: pix3.h Biblioteca: pixevt.lib Plataformas compatíveis: consoles da família XBOX One e consoles XBOX SeriesConfira também
Visão geral do PIX (tópico sob NDA)pix3
PIXSetMarker
PIXSetMarker_2
PIXSetMarker_3
PIXBeginEvent