DXGI_USAGE

  • Article

Indicateurs pour les options de création de surface et de ressource.

Constante/valeur Description
DXGI_USAGE_BACK_BUFFER
1L << (2 + 4)
 La surface ou la ressource est utilisée comme mémoire tampon d’arrière-mémoire. Vous n’avez pas besoin de passer DXGI_USAGE_BACK_BUFFER lorsque vous créez une chaîne d’échange. Toutefois, vous pouvez déterminer si une ressource appartient à une chaîne d’échange lorsque vous appelez IDXGIResource::GetUsage et obtenez DXGI_USAGE_BACK_BUFFER.
DXGI_USAGE_DISCARD_ON_PRESENT
1L << (5 + 4)
 Cet indicateur est destiné à un usage interne uniquement.
DXGI_USAGE_READ_ONLY
1L << (4 + 4)
 Utilisez la surface ou la ressource pour la lecture uniquement.
DXGI_USAGE_RENDER_TARGET_OUTPUT
1L << (1 + 4)
 Utilisez la surface ou la ressource comme cible de rendu de sortie.
DXGI_USAGE_SHADER_INPUT
1L << (0 + 4)
 Utilisez la surface ou la ressource comme entrée dans un nuanceur.
DXGI_USAGE_SHARED
1L << (3 + 4)
 Partagez la surface ou la ressource.
DXGI_USAGE_UNORDERED_ACCESS
1L << (6 + 4)
 Utilisez la surface ou la ressource pour un accès non ordonné.

Notes

Chaque indicateur est défini comme un entier non signé.

#define DXGI_CPU_ACCESS_NONE    ( 0 )
#define DXGI_CPU_ACCESS_DYNAMIC    ( 1 )
#define DXGI_CPU_ACCESS_READ_WRITE    ( 2 )
#define DXGI_CPU_ACCESS_SCRATCH    ( 3 )
#define DXGI_CPU_ACCESS_FIELD        15
#define DXGI_USAGE_SHADER_INPUT             ( 1L << (0 + 4) )
#define DXGI_USAGE_RENDER_TARGET_OUTPUT     ( 1L << (1 + 4) )
#define DXGI_USAGE_BACK_BUFFER              ( 1L << (2 + 4) )
#define DXGI_USAGE_SHARED                   ( 1L << (3 + 4) )
#define DXGI_USAGE_READ_ONLY                ( 1L << (4 + 4) )
#define DXGI_USAGE_DISCARD_ON_PRESENT       ( 1L << (5 + 4) )
#define DXGI_USAGE_UNORDERED_ACCESS         ( 1L << (6 + 4) )
typedef UINT DXGI_USAGE;

Ces options d’indicateur sont utilisées dans un appel à la méthode IDXGIFactory::CreateSwapChain, IDXGIFactory2::CreateSwapChainForHwnd, IDXGIFactory2::CreateSwapChainForCoreWindow ou IDXGIFactory2::CreateSwapChainForComposition pour décrire l’utilisation de la surface et les options d’accès au processeur pour la mémoire tampon d’arrière-mémoire d’une chaîne d’échange. Vous ne pouvez pas utiliser les valeurs DXGI_USAGE_SHARED, DXGI_USAGE_DISCARD_ON_PRESENT et DXGI_USAGE_READ_ONLY comme entrée pour créer une chaîne d’échange. Toutefois, DXGI peut définir DXGI_USAGE_DISCARD_ON_PRESENT et DXGI_USAGE_READ_ONLY pour certaines mémoires tampons d’arrière-mémoire de la chaîne d’échange pour le compte de l’application. Vous pouvez appeler la méthode IDXGIResource::GetUsage pour récupérer l’utilisation de ces mémoires tampons d’arrière-mémoire. Les chaînes d’échange prennent uniquement en charge la valeur DXGI_CPU_ACCESS_NONE dans la partie DXGI_CPU_ACCESS_FIELD de DXGI_USAGE.

Ces options d’indicateur sont également utilisées par la méthode IDXGIDevice::CreateSurface .

Spécifications

Condition requise Valeur
En-tête
DXGI.h

Voir aussi

Constantes DXGI