Referencia de la función PIXSetMarker
Inserta un marcador en la escala de tiempo de la GPU en la ventana PIX System Timing Capture, 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
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 GPU. Para marcar eventos en la escala de tiempo de la CPU, llame a la primera sobrecarga de la función PIXSetMarker o a la segunda 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
PIXSetMarkerPIXSetMarker_2
PIXSetMarker_4
PIX3
PIX (tema NDA)