PFND3D12DDI_BEGIN_END_QUERY fonction de rappel (d3d12umddi.h)

Article
02/26/2024

La fonction de rappel pfnBeginEndQuery définit le début de la partie d’une liste de commandes à laquelle une requête s’applique.

Syntaxe

PFND3D12DDI_BEGIN_END_QUERY Pfnd3d12ddiBeginEndQuery;

void Pfnd3d12ddiBeginEndQuery(
  D3D12DDI_HCOMMANDLIST unnamedParam1,
  D3D12DDI_HQUERYHEAP unnamedParam2,
  UINT unnamedParam3,
  D3D12DDI_QUERY_TYPE unnamedParam4
)
{...}

Paramètres

unnamedParam1

hCommandList

Handle pour les données du pilote pour la liste de commandes. Le pilote utilise cette région de mémoire pour stocker les structures de données internes liées à sa liste de commandes.

unnamedParam2

hQueryHeap

Handle d’un tas de requête, qui représente un tableau de résultats de requête. La représentation des données sous-jacentes d’un résultat de requête est dépendante de l’IHV dans les tas de requête et opaque pour les applications. Les résultats de la requête sont stockés dans un tas de requête jusqu’à ce qu’ils soient plus tard « résolus » dans le format défini par l’API.

unnamedParam3

StartElement

Valeur de l’élément start.

unnamedParam4

QueryType

Type de requête. Resolve est utilisé par les applications pour transformer un résultat de requête précédemment stocké dans un tas de requête dans le format défini par l’API. Les données résolues sont stockées dans une mémoire tampon D3D12. Les résultats peuvent ensuite être consommés par un nuanceur, une prédication ou mappés et lus sur le processeur.

Valeur de retour

None

Remarques

La requête de début/fin et la requête de résolution sont des commandes planifiées qui sont traitées sur le GPU. Il n’existe aucun point d’entrée défini pour autoriser le traitement du processeur sur les résultats de la requête.

Les requêtes qui ne s’appliquent pas à plusieurs commandes peuvent être définies pour utiliser uniquement EndQuery. Par exemple, si la requête D3D12DDI_QUERY_TYPE_VIDEO_DECODE_STATISTICS s’applique uniquement à la commande DecodeFrame précédente dans la même liste de commandes, seul EndQuery est utilisé pour ce type de requête.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10
En-tête	d3d12umddi.h (incluez d3d12umddi.h)

Partager via