IHolographicCameraRenderingParametersInterop::CommitDirect3D12ResourceWithDepthData-Methode (windows.graphics.holographic.interop.h)

Committent einen Direct3D 12-Puffer für die Darstellung von Ausgaben, die der HolographicCamera zugeordnet sind. Der Puffer muss durch Aufrufen von CreateDirect3D12BackBufferResource oder CreateDirect3D12HardwareProtectedBackBufferResource auf derselben HolographicCamera erstellt worden sein, für die ein Commit ausgeführt wird.

Diese Methode akzeptiert auch einen optionalen Tiefenpufferparameter sowie einen Zaun- und Zaunwert für den Abschluss der App-Arbeit für diesen Puffer. Dieser Tiefenpuffer wird für die Bildstabilisierung verwendet, wenn der Frame angezeigt wird, für den ein Commit ausgeführt wird. Der Tiefenpuffer muss Tiefendaten enthalten, die mit der Geometrie korreliert sind, die zum Zeichnen von Hologrammen im Farbpuffer verwendet wird, der gleichzeitig übermittelt wird. Der Tiefenpuffer sollte keine Tiefendaten für unsichtbare Inhalte enthalten, z. B. Tiefendaten, die für die Okklusion verwendet werden.

Syntax

HRESULT CommitDirect3D12ResourceWithDepthData(
  ID3D12Resource *pColorResourceToCommit,
  ID3D12Fence    *pColorResourceFence,
  UINT64         colorResourceFenceSignalValue,
  ID3D12Resource *pDepthResourceToCommit,
  ID3D12Fence    *pDepthResourceFence,
  UINT64         depthResourceFenceSignalValue
);

Parameter

pColorResourceToCommit

Typ: ID3D12Resource*

Die Direct3D 12-Texturressource mit Inhalten, die bei der Darstellung des HolographicFrame zum Abrufen dieses Renderingparameterobjekts angezeigt werden sollen.

pColorResourceFence

Typ: ID3D12Fence*

Ein Zaun, der verwendet wird, um den Abschluss der App-Arbeit für die durch pColorResourceToCommit angegebene Farbpufferressource zu signalisieren. Abschluss dieses Zauns mit dem wert, der durch colorResourceFenceSignalValue angegeben ist, signalisiert die Übertragung der Steuerung der Farbressource von Ihrer Anwendung auf die Plattform in der GPU-Arbeitswarteschlange. Die Plattform basiert auf diesem Zaun und dem in colorResourceFenceSignalValue angegebenen Wert, um die Arbeit auf der GPU in die Warteschlange zu stellen, die aus dem Farbpuffer liest.

colorResourceFenceSignalValue

Typ: UINT64

Der Wert, der verwendet wird, um den Abschluss der Arbeit auf pColorResourceFence zu signalisieren. Die Plattform basiert auf diesem Zaunwert, um die Arbeit auf der GPU in die Warteschlange zu stellen, die aus dem Farbpuffer liest.

pDepthResourceToCommit

Typ: ID3D12Resource*

Der Direct3D 12-Tiefenpuffer mit Tiefendaten, die bei der Darstellung des HolographicFrame zum Abrufen dieses Renderingparameterobjekts für die Bildstabilisierung verwendet werden sollen. Anwendungen übermitteln in der Regel die Tiefenschablone, die beim Rendern in pColorResourceToCommit verwendet wird, oder einen Tiefenpuffer, der aus demselben Renderingdurchlauf abgeleitet wird. Der Tiefenpuffer sollte nur Daten enthalten, die der Geometrie entsprechen, die zum Rendern von Hologrammen im Farbpuffer verwendet wird. Beispielsweise sollten Okklusionsdaten nicht eingeschlossen werden und können von der Plattform ignoriert werden.

pDepthResourceFence

Typ: ID3D12Fence*

Ein Zaun, der verwendet wird, um den Abschluss der Arbeit für die durch pDepthResourceToCommit angegebene Tiefenpufferressource-Ressource zu signalisieren. Der Abschluss dieses Zauns mit dem durch depthResourceFenceSignalValue angegebenen Wert signalisiert die Übertragung der Steuerung der Tiefenressource von Ihrer Anwendung auf die Plattform in der GPU-Arbeitswarteschlange. Die Plattform basiert auf diesem Zaun und dem in colorResourceFenceSignalValue angegebenen Wert, um die Arbeit auf der GPU in die Warteschlange zu stellen, die aus dem Tiefenpuffer liest.

depthResourceFenceSignalValue

Typ: UINT64

Der Wert, der verwendet wird, um den Abschluss der Arbeit auf pDepthResourceFence zu signalisieren. Die Plattform basiert auf diesem Umgrenzungswert, um die Arbeit auf der GPU in die Warteschlange zu stellen, die aus dem Tiefenpuffer liest.

Rückgabewert

S_OK , wenn erfolgreich, gibt andernfalls einen HRESULT-Fehlercode zurück, der den Grund für den Fehler angibt. Siehe auch COM-Fehlercodes (UI, Audio, DirectX, Codec).

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 2004 (10.0; Build 19041)
Unterstützte Mindestversion (Server)	Windows Server, Version 2004 (10.0; Build 19041)
Kopfzeile	windows.graphics.holographic.interop.h