Información general de PIXBeginEvent
Inicia un evento definido por el usuario para una captura de tiempos de la actividad de la CPU, que se mostrará en la característica System Timing Capture de PIX.Sintaxis
Parámetros
contextTipo: void* Contexto para el evento; acepta
ID3D12GraphicsCommandList\*, ID3D12GraphicsCommandList\* y ID3D12XboxDmaCommandList\* (solo XBOX).
color Tipo: UINT64 El color del evento que se usará en el gráfico de tiempos del sistema. Use PIX_COLOR para especificar un color, 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 un 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 cuyos tipos dependen de los marcadores de posición. Este método admite hasta un máximo de 16 parámetros de formato.
Valor devuelto
Tipo: voidComentarios
La funciónPIXBeginEvent 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 posteriormente al leer los archivos de captura en PIX. Use cadenas alineadas a 16 bytes (preferible) o cadenas alineadas a 8 bytes con PIXBeginEvent para obtener el mejor rendimiento. Para imprimir un char* o wchar_t* como puntero mediante el especificador de formato %p, convierta el puntero en void* o en un puntero a un tipo entero o de punto flotante al pasarlo a PIXBeginEvent. Para obtener el mejor rendimiento, use una cadena asignada estáticamente.
Las llamadas a PIXBeginEvent 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 alinean con los componentes, sistemas o contenido principales de su juego.
Este método se usa para medir el tiempo de los eventos de CPU. Para obtener más información sobre cómo medir el tiempo de los eventos de GPU, consulte la sección API de captura de GPU de PIX de PIX3.
Cada llamada a PIXBeginEvent debe tener una llamada coincidente a PIXEndEvent. Las llamadas emparejadas a PIXBeginEvent y PIXEndEvent deben producirse en el mismo subproceso. El intervalo de tiempo es de unos 200 ns y esta función tiene una sobrecarga baja, por lo que se pueden realizar hasta varios cientos de miles de llamadas a PIXBeginEvent por segundo.
Los pares PIXBeginEvent y PIXEndEvent se pueden anidar a cualquier profundidad.
Requisitos
Encabezado: pix3.h Biblioteca: pixevt.lib Plataformas compatibles: consolas de la familia XBOX One y consolas XBOX SeriesConsulte también
PIX (tema de NDA)pix3
PIXEndEvent
PIXBeginEvent
PIXBeginEvent_2
PIXBeginEvent_3