ID3D10Device ::SetPredication, méthode (d3d10.h)

Définissez un prédicat de rendu.

Syntaxe

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

Paramètres

[in] pPredicate

Type : ID3D10Predicate*

Pointeur vers un prédicat (voir ID3D10Predicate). Une valeur NULL indique la prédication « no » ; dans ce cas, la valeur de PredicateValue n’est pas pertinente, mais sera conservée pour ID3D10Device ::GetPredication.

[in] PredicateValue

Type : BOOL

Si la valeur est TRUE, le rendu est affecté par le moment où les conditions du prédicat sont remplies. Si la valeur est FALSE, le rendu est affecté lorsque les conditions ne sont pas remplies.

Valeur de retour

None

Remarques

Le prédicat doit être à l’état « émis » ou « signalé » pour être utilisé pour la prédication. Bien que le prédicat soit défini pour la prédication, les appels à ID3D10Asynchronous ::Begin et ID3D10Asynchronous ::End ne sont pas valides.

Cette méthode est utilisée pour indiquer que les commandes de rendu et de manipulation des ressources suivantes ne sont pas réellement effectuées si les données de prédicat obtenues du prédicat sont égales à predicateValue. Toutefois, certains prédicats ne sont que des indicateurs, de sorte qu’ils n’empêchent pas réellement l’exécution d’opérations.

La principale utilité de la prédication est de permettre à une application d’émettre des commandes graphiques sans avoir à atteindre les performances de la rotation, en attendant le retour d’ID3D10Asynchronous ::GetData . Ainsi, la prédication peut se produire alors qu’ID3D10Asynchronous ::GetData retourne S_FALSE. Autre façon d’y penser : une application peut également utiliser la prédication comme secours, s’il est possible qu’ID3D10Asynchronous ::GetData retourne S_FALSE. Si ID3D10Asynchronous ::GetData retourne S_OK, l’application peut ignorer l’appel manuel des commandes graphics avec sa propre logique d’application.

Configuration requise

Voir aussi

ID3D10Device Interface