PIXSetRetailMarker
Inserta un marcador comercial, cuando se produce un evento determinado definido por el usuario.Sintaxis
Parámetros
contextTipo: void* Contexto del evento; acepta ID3D12GraphicsCommandList* , ID3D12CommandQueue* e ID3D12XboxDmaCommandList* (solo XBOX). color
Tipo: UINT64 El color que se usará en el gráfico de tiempos cuando este evento se produzca en las ventanas de PIX.
Use PIX_COLOR para especificar un color, use PIX_COLOR_INDEX para especificar un índice de color, o pase un DWORD sin procesar teniendo en cuenta que el formato es ARGB y el valor del canal alfa debe ser 0xff. formatString _In_
Tipo: PCWSTR El nombre que se usará para describir el evento, como puntero a una cadena Unicode terminada en null. La cadena puede especificar cero o más marcadores de posición de formato de cadena opcionales, de forma muy similar al formato de sprintf. Tipo: … Si se usan marcadores de posición en formatString, debe haber un número correspondiente de parámetros (hasta un máximo de 16) cuyos tipos coincidan con los marcadores de posición.
Valor devuelto
Tipo: voidComentarios
Con un dispositivo de depuración o instrumentado,PIXSetRetailMarker se comporta de forma idéntica a PIXSetMarker. En un dispositivo comercial, los marcadores se incluirán en los archivos HIX para la depuración de bloqueos de GPU.
Las llamadas a PIXSetRetailMarker pueden producirse en cualquier lugar y no tienen que seguir a una llamada a PIXBeginRetailEvent.
Requisitos
Encabezado: pix3.h Biblioteca: pixevt.lib Plataformas compatibles: consolas de la familia XBOX One y consolas XBOX SeriesConsulte también
Información general de PIX (tema NDA)pix3
PIXSetRetailMarker(void*, UINT64, PCSTR, …)
PIXBeginRetailEvent