Função PIXSetRetailMarker
Insere um marcador de varejo quando ocorre um determinado evento definido pelo usuário.Sintaxe
Parâmetros
contextTipo: void* Contexto do evento; aceita 1ID3D12GraphicsCommandList*
,ID3D12CommandQueue*eID3D12XboxDmaCommandList*` (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: PCSTR O nome a ser usado para descrever o evento. 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
Com um dispositivo de depuração ou instrumentado,PIXSetRetailMarker se comporta de forma idêntica a PIXSetMarker. Para um dispositivo de varejo, os marcadores serão incluídos em arquivos HIX para a depuração de travamentos da GPU.
As chamadas a PIXSetRetailMarker podem ocorrer em qualquer lugar e não precisam vir depois de uma chamada a PIXBeginRetailEvent.
Requisitos
Cabeçalho: pix3.h Biblioteca: pixevt.lib Plataformas compatíveis: consoles da família XBOX One e consoles XBOX SeriesConfira também
PIXSetRetailMarker(void*, UINT64, PCWSTR, …)pix3
PIX (tópico sob NDA)