PIXSetRetailMarker
Insere um marcador de varejo 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
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
Visão geral do PIX (tópico sob NDA)pix3
PIXSetRetailMarker(void*, UINT64, PCSTR, …)
PIXBeginRetailEvent