ID3D11DeviceContext ::SOSetTargets, méthode (d3d11.h)

  • Article

Définissez les mémoires tampons de sortie cibles pour l’étape de sortie de flux du pipeline.

Syntaxe

void SOSetTargets(
  [in]           UINT         NumBuffers,
  [in, optional] ID3D11Buffer * const *ppSOTargets,
  [in, optional] const UINT   *pOffsets
);

Paramètres

[in] NumBuffers

Type : UINT

Nombre de mémoire tampon à lier à l’appareil. Un maximum de quatre mémoires tampons de sortie peut être défini. Si moins de quatre sont définis par l’appel, les emplacements de mémoire tampon restants sont définis sur NULL. Consultez la section Notes.

[in, optional] ppSOTargets

Type : ID3D11Buffer*

Tableau de mémoires tampons de sortie (voir ID3D11Buffer) à lier à l’appareil. Les mémoires tampons doivent avoir été créées avec l’indicateur D3D11_BIND_STREAM_OUTPUT .

[in, optional] pOffsets

Type : const UINT*

Tableau de décalages vers les mémoires tampons de sortie de ppSOTargets, un décalage pour chaque mémoire tampon. Les valeurs de décalage doivent être en octets.

Valeur de retour

None

Remarques

Un décalage de -1 entraîne l’ajout de la mémoire tampon de sortie du flux, qui se poursuit après le dernier emplacement écrit dans la mémoire tampon lors d’un passage de sortie de flux précédent.

L’appel de cette méthode à l’aide d’une mémoire tampon actuellement liée à l’écriture liera effectivement null à la place, car une mémoire tampon ne peut pas être liée à la fois en tant qu’entrée et en sortie.

La couche de débogage génère un avertissement chaque fois qu’une ressource ne peut pas être liée simultanément en tant qu’entrée et en sortie, mais cela n’empêche pas l’utilisation de données non valides par le runtime.

La méthode contient une référence aux interfaces transmises. Cela diffère du comportement de l’état de l’appareil dans Direct3D 10.

Notez que contrairement à d’autres méthodes de ressources dans Direct3D, toutes les cibles actuellement liées seront dissociées en appelant SOSetTargets(0, nullptr, nullptr);.

Windows Phone 8 : Cette API est prise en charge.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête d3d11.h
Bibliothèque D3D11.lib

Voir aussi

ID3D11DeviceContext