Partager via


PFND3D12DDI_BEGIN_PASS fonction de rappel (d3d12umddi.h)

Le pilote est averti que l’application a démarré d’un passage de charges de travail cohérentes. Lorsque le pilote est averti qu’une passe d’application a démarré, il enregistre les observations ou utilise des optimisations qui ont été découvertes.

Syntaxe

PFND3D12DDI_BEGIN_PASS Pfnd3d12ddiBeginPass;

void Pfnd3d12ddiBeginPass(
  D3D12DDI_HCOMMANDLIST unnamedParam1,
  D3D12DDI_HPASS unnamedParam2,
  D3D12DDI_PASS_FLAGS PassFlags
)
{...}

Paramètres

unnamedParam1

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

Handle de la passe créée par l’application.

PassFlags

Indicateur pour indiquer ce que le pilote doit faire lorsqu’une application démarre une passe.

Valeur de retour

None

Remarques

Ce rappel est utilisé dans le cadre d’un test pour voir si les pilotes peuvent trouver des avantages d’être informés lorsque les applications répètent des « passes » de charges de travail cohérentes. L’application indique au pilote d’observer la façon dont certaines passes s’exécutent et lui donne la possibilité d’effectuer des optimisations pour les exécutions futures du même passage. Le contenu d’une « passe » peut être n’importe quoi : il appartient à l’application d’être relativement cohérente dans les caractéristiques de performances globales d’un passage.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10
Version UMDF minimale D3D12DDI_SUPPORTED_0020
En-tête d3d12umddi.h