Información general de PIXScopedEvent
Crea un evento definido por el usuario para una captura de tiempos específica de un contexto de la actividad de la CPU o, solo para XBOX, de la actividad de la GPU, que se mostrará en la característica Timing Capture de Performance Investigator para XBOX (PIX).Sintaxis
Parámetros
contextTipo: void* El contexto del evento. Solo para XBOX, este parámetro también acepta punteros
ID3D12GraphicsCommandList*, ID3D12GraphicsCommandList* e ID3D12XboxDmaCommandList*, para permitir capturas de tiempos de la actividad de la GPU.
color Tipo: UINT64 El color del evento que se usará en el gráfico de escala de tiempo. Especifique una constante PIX_COLOR para usar un color predefinido, una constante PIX_COLOR_INDEX para usar un índice de color, o un valor DWORD en formato ARGB para usar un color personalizado. Si se especifica un valor DWORD con formato ARGB, el canal alfa de ese valor debe establecerse en
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. Este método admite hasta 16 marcadores de posición.
Tipo: …
Si se especifican marcadores de posición en formatString, debe especificar un número correspondiente de valores en este parámetro. Los tipos de los valores especificados en este parámetro dependen de los tipos identificados por sus marcadores de posición correspondientes.
Valor devuelto
Tipo: void Ninguno.Comentarios
Esta función crea un evento definido por el usuario para una captura de tiempos de la actividad de la CPU, que se mostrará en la característica Timing Capture de PIX. Los eventos creados conPIXScopedEvent finalizan automáticamente cuando se sale del ámbito en el que se llama a la API, lo que hace que el emparejamiento del inicio y el final del evento sea automático.
La función PIXScopedEvent 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 los archivos de captura en PIX. Use cadenas alineadas a 8 bytes o, preferiblemente, cadenas alineadas a 16 bytes con PIXScopedEvent para obtener el mejor rendimiento. Para dar formato a un char\* o wchar_t\* como puntero usando el especificador de formato %p, convierta el puntero a un void\* o a cualquier tipo entero o de punto flotante al pasar el puntero a PIXScopedEvent.
Las llamadas a PIXScopedEvent tienen garantizados al menos 512 bytes de espacio para guardar los datos del registro, lo que incluye el tamaño completo y la alineación de la cadena de formato y todas las variables. En general, los eventos de PIX están pensados para marcadores cortos de alto rendimiento que se alineen con los componentes, sistemas o contenido principales de su juego.
Este método se usa normalmente para medir el tiempo de los eventos de CPU. Sin embargo, pasar un puntero ID3D12GraphicsCommandList*, ID3D12CommandQueue* o ID3D12XboxDmaCommandList* en el parámetro context permite medir también el tiempo de los eventos de GPU.
Requisitos
Encabezado: pix3.h Biblioteca: pixevt.lib Plataformas compatibles: consolas de la familia XBOX One y consolas XBOX SeriesConsulte también
PIXScopedEventPIX3
PIX (tema NDA)