ID3D10Device::SetPredication-Methode (d3d10.h)

Artikel
08/22/2023

Legen Sie ein Rendering-Prädikat fest.

Syntax

void SetPredication(
  [in] ID3D10Predicate *pPredicate,
  [in] BOOL            PredicateValue
);

Parameter

[in] pPredicate

Typ: ID3D10Predicate*

Zeiger auf ein Prädikat (siehe ID3D10Predicate). Ein NULL-Wert gibt "keine" Prädication an. in diesem Fall ist der Wert von PredicateValue irrelevant, wird aber für ID3D10Device::GetPredication beibehalten.

[in] PredicateValue

Typ: BOOL

Wenn TRUE, wird das Rendern davon beeinflusst, wann die Bedingungen des Prädikats erfüllt sind. Wenn FALSE, wird das Rendering beeinträchtigt, wenn die Bedingungen nicht erfüllt sind.

Rückgabewert

Keine

Bemerkungen

Das Prädikat muss sich im Zustand "ausgestellt" oder "signalisiert" befinden, um für die Prädication verwendet zu werden. Während das Prädikat für die Prädication festgelegt ist, sind Aufrufe von ID3D10Asynchronous::Begin und ID3D10Asynchronous::End ungültig.

Diese Methode wird verwendet, um anzugeben, dass nachfolgende Rendering- und Ressourcenbearbeitungsbefehle nicht tatsächlich ausgeführt werden, wenn die resultierenden Prädikatdaten des Prädikats dem PredicateValue entsprechen. Einige Prädikate sind jedoch nur Hinweise, sodass sie möglicherweise nicht wirklich verhindern, dass Vorgänge ausgeführt werden.

Der primäre Nutzen von Predication besteht darin, einer Anwendung das Ausgeben von Grafikbefehlen zu ermöglichen, ohne den Leistungstreffer des Drehens zu nehmen und darauf zu warten, dass ID3D10Asynchronous::GetData zurückgegeben wird. Die Prädication kann also auftreten, während ID3D10Asynchronous::GetData S_FALSE zurückgibt. Eine andere Möglichkeit, es sich vorzudenken: Eine Anwendung kann auch Predication als Fallback verwenden, wenn es möglich ist, dass ID3D10Asynchronous::GetData S_FALSE zurückgibt. Wenn ID3D10Asynchronous::GetData S_OK zurückgibt, kann die Anwendung das manuelle Aufrufen der Grafikbefehle mit ihrer eigenen Anwendungslogik überspringen.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	d3d10.h
Bibliothek	D3D10.lib

Weitere Informationen

ID3D10Geräteschnittstelle

Freigeben über