PFND3D12DDI_BEGIN_PASS Rückruffunktion (d3d12umddi.h)

Der Treiber wird benachrichtigt, dass die App einen Durchlauf konsistenter Workloads gestartet hat. Wenn der Treiber benachrichtigt wird, dass ein App-Pass gestartet wurde, zeichnet der Treiber entweder Beobachtungen auf oder verwendet ermittelte Optimierungen.

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 diese Speicherregion, um interne Datenstrukturen zu speichern, die sich auf die Befehlsliste beziehen.

unnamedParam2

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

PassFlags

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

Rückgabewert

Keine

Bemerkungen

Dieser Rückruf wird als Teil eines Tests verwendet, um zu ermitteln, ob Treiber Leistungsvorteile finden können, wenn sie davon erfahren, wenn Apps "Pässe" konsistenter Workloads wiederholen. Die App weist den Treiber an, zu beobachten, wie einige Pässe ausgeführt werden, und gibt dem Treiber die Möglichkeit, Optimierungen für zukünftige Ausführungen desselben Durchlaufs vorzunehmen. Der Inhalt eines "Durchlaufs" kann beliebig sein – es liegt an der App, in den Gesamtleistungsmerkmalen eines Durchlaufs relativ konsistent zu sein.

Anforderungen