PFND3D12DDI_BEGIN_PASS Rückruffunktion (d3d12umddi.h)

Artikel
02/06/2025

Der Treiber wird benachrichtigt, dass die App mit einem Durchlauf konsistenter Workloads begonnen hat. Wenn der Treiber benachrichtigt wird, dass ein App-Pass gestartet wurde, zeichnet der Treiber entweder Beobachtungen auf oder verwendet Optimierungen, die ermittelt wurden.

Syntax

PFND3D12DDI_BEGIN_PASS Pfnd3d12ddiBeginPass;

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

Parameter

unnamedParam1

Ein Handle für die Treiberdaten für die Befehlsliste. Der Treiber verwendet diesen Speicherbereich, um interne Datenstrukturen zu speichern, die mit der Befehlsliste zusammenhängen.

unnamedParam2

Ein Handle für den Pass, der von der App erstellt wurde.

PassFlags

Ein Kennzeichen, das angibt, was der Treiber tun soll, wenn eine App einen Pass startet.

Rückgabewert

Nichts

Bemerkungen

Dieser Rückruf wird als Teil eines Tests verwendet, um festzustellen, ob Treiber feststellen können, dass perf sie feststellen können, wann Apps wiederholte "Durchläufe" konsistenter Workloads wiederholen. Die App weist den Fahrer an, zu beobachten, wie einige Durchläufe ausgeführt werden und dem Fahrer die Möglichkeit geben, Optimierungen für zukünftige Laufläufe desselben Durchgangs vorzunehmen. Der Inhalt eines "Pass" kann alles sein – es liegt an der App, relativ konsistent in den Gesamtleistungsmerkmalen eines Durchgangs zu sein.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10
Mindest-UMDF-Version	D3D12DDI_SUPPORTED_0020
Header-	d3d12umddi.h

Freigeben über