Función PIXSetMarker
Inserta un marcador en la escala de tiempo de la CPU en la ventana PIX System Timing Capture, cuando se produce un evento determinado definido por el usuario.Sintaxis
Parámetros
colorTipo: 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
La funciónPIXSetMarker guarda la cadena de formato y los parámetros de formato en lugar de dar formato a la cadena en tiempo de ejecución. El formato se aplica después, al leer el archivo de captura en PIX. Use cadenas alineadas a 16 bytes (preferible) o cadenas alineadas a 8 bytes con PIXSetMarker para obtener el mejor rendimiento. Para imprimir un char* o wchar_t* como puntero usando el especificador de formato %p, convierta el puntero a void* o a un puntero a un tipo entero o de punto flotante al pasarlo a PIXSetMarker. Cualquier llamada a PIXSetMarker tiene garantizados al menos 512 bytes de espacio para guardar los datos del registro.
El evento se mostrará sin duración, y estará representado por una sola línea (una única barra vertical) en la ventana PIX System Timing Capture.
Esta función se usa para marcar eventos en la escala de tiempo de la CPU. Para marcar eventos en la escala de tiempo de la GPU, llame a la tercera sobrecarga de la función PIXSetMarker o a la cuarta sobrecarga de la función PIXSetMarker
Las llamadas a PIXSetMarker pueden producirse en cualquier lugar y no tienen que seguir a una llamada a PIXBeginEvent.
Requisitos
Encabezado: pix3.h Biblioteca: pixevt.lib Plataformas compatibles: consolas de la familia XBOX One y consolas XBOX SeriesConsulte también
PIXSetMarker_2PIXSetMarker_3
PIXSetMarker_4
PIX3
PIX (tema NDA)