Função PIXBeginRetailEvent
Inicia um evento de varejo definido pelo usuário.Sintaxe
Parâmetros
contextTipo: void* Contexto do evento; aceita
ID3D12GraphicsCommandList\* , ID3D12GraphicsCommandList\* e ID3D12XboxDmaCommandList\* (somente XBOX).
color Tipo: UINT64 A cor do evento a ser usada no gráfico de tempo do sistema. Use PIX_COLOR para especificar uma cor, PIX_COLOR_INDEX para especificar um índice de cor ou passe um DWORD bruto, observando que o formato é ARGB e o valor do canal alfa deve ser 0xff.
formatString _In_
Tipo: PCSTR O nome a ser usado para descrever o evento, como um ponteiro para uma cadeia de caracteres 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 forem usados espaços reservados em formatString, deverá haver um número correspondente de parâmetros cujos tipos dependem dos espaços reservados. Este método dá suporte a no máximo 16 parâmetros de formato.
Valor retornado
Tipo: voidComentários
Com um dispositivo de depuração ou instrumentado,PIXBeginRetailEvent se comporta de forma idêntica a PIXBeginEvent. Em um dispositivo de varejo, os eventos serão incluídos nos arquivos HIX para depuração de travamentos da GPU.
Os pares PIXBeginRetailEvent e PIXEndRetailEvent podem ser aninhados em qualquer profundidade.
Requisitos
Cabeçalho: pix3.h Biblioteca: pixevt.lib Plataformas com suporte: consoles da família XBOX One e consoles XBOX SeriesConfira também
PIXBeginRetailEvent(void*,UINT64, PCWSTR, …)PIXEndRetailEvent
pix3
PIX (tópico sob NDA)