PIXBeginRetailEvent
Inicia un evento comercial definido por el usuario.Sintaxis
Parámetros
contextTipo: void* Contexto del evento; acepta
ID3D12GraphicsCommandList\*, ID3D12GraphicsCommandList\* e 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 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
Con un dispositivo de depuración o instrumentado,PIXBeginRetailEvent se comporta de forma idéntica a PIXBeginEvent. En un dispositivo comercial, los eventos se incluirán en los archivos HIX para la depuración de bloqueos de GPU.
Los pares de PIXBeginRetailEvent y PIXEndRetailEvent 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 NDA)pix3
PIXEndRetailEvent
PIXBeginRetailEvent(void*, UINT64, PCSTR, …)