DXGI_USAGE

  • Artikel

Flags für Oberflächen- und Ressourcenerstellungsoptionen.

Konstante/Wert Beschreibung
DXGI_USAGE_BACK_BUFFER
1L << (2 + 4)
 Die Oberfläche oder Ressource wird als Backpuffer verwendet. Sie müssen DXGI_USAGE_BACK_BUFFER nicht übergeben, wenn Sie eine Swapchain erstellen. Sie können jedoch feststellen, ob eine Ressource zu einer Swap chain gehört, wenn Sie IDXGIResource::GetUsage aufrufen und DXGI_USAGE_BACK_BUFFER abrufen.
DXGI_USAGE_DISCARD_ON_PRESENT
1L << (5 + 4)
 Dieses Flag ist nur für die interne Verwendung vorgesehen.
DXGI_USAGE_READ_ONLY
1L << (4 + 4)
 Verwenden Sie die Oberfläche oder Ressource nur zum Lesen.
DXGI_USAGE_RENDER_TARGET_OUTPUT
1L << (1 + 4)
 Verwenden Sie die Oberfläche oder Ressource als Ausgaberenderungsziel.
DXGI_USAGE_SHADER_INPUT
1L << (0 + 4)
 Verwenden Sie die Oberfläche oder Ressource als Eingabe für einen Shader.
DXGI_USAGE_SHARED
1L << (3 + 4)
 Teilen Sie die Oberfläche oder Ressource.
DXGI_USAGE_UNORDERED_ACCESS
1L << (6 + 4)
 Verwenden Sie die Oberfläche oder Ressource für ungeordneten Zugriff.

Bemerkungen

Jedes Flag ist als ganze Zahl ohne Vorzeichen definiert.

#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;

Diese Flagoptionen werden in einem Aufruf der METHODEN IDXGIFactory::CreateSwapChain, IDXGIFactory2::CreateSwapChainForHwnd, IDXGIFactory2::CreateSwapChainForCoreWindow oder IDXGIFactory2::CreateSwapChainForComposition verwendet, um die Oberflächennutzungs- und CPU-Zugriffsoptionen für den Backpuffer einer Swap chain zu beschreiben. Sie können die Werte DXGI_USAGE_SHARED, DXGI_USAGE_DISCARD_ON_PRESENT und DXGI_USAGE_READ_ONLY nicht als Eingabe verwenden, um eine Swapchain zu erstellen. DXGI kann jedoch DXGI_USAGE_DISCARD_ON_PRESENT und DXGI_USAGE_READ_ONLY für einige der Backpuffer der Swapchain im Auftrag der Anwendung festlegen. Sie können die IDXGIResource::GetUsage-Methode aufrufen, um die Verwendung dieser Backpuffer abzurufen. Swap chain's unterstützt nur den DXGI_CPU_ACCESS_NONE Wert im DXGI_CPU_ACCESS_FIELD Teil von DXGI_USAGE.

Diese Flagoptionen werden auch von der IDXGIDevice::CreateSurface-Methode verwendet.

Anforderungen

Anforderung Wert
Header
DXGI.h

Siehe auch

DXGI-Konstanten