Función PIXSetRetailMarker
Inserta un marcador comercial, cuando se produce un evento determinado definido por el usuario.Sintaxis
Parámetros
contextTipo: void* Contexto del evento; acepta 1ID3D12GraphicsCommandList*
,ID3D12CommandQueue*eID3D12XboxDmaCommandList*` (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: PCSTR El nombre que se usará para describir el evento. 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
PIXSetRetailMarker(void*, UINT64, PCWSTR, …)pix3
PIX (tema NDA)