Skip to main content
Définit les paramètres utilisés lors de la création d’un périphérique sur le matériel des consoles XBOX Series.

Syntaxe

Membres

Version
Type : UINT
Spécifie la version du SDK. Définissez-la à D3D12_SDK_VERSION. ProcessDebugFlags
Type : D3D12XBOX_PROCESS_DEBUG_FLAGS
Spécifie les indicateurs à utiliser pour déboguer un processus. Ce paramètre remplace tous les réglages définis par D3D12XboxSetProcessDebugFlags ou SetProcessDebugFlags. GraphicsCommandQueueRingSizeBytes
Type : UINT
Spécifie la quantité de mémoire à réserver pour les mémoires tampons circulaires des files d’attente de commandes. La valeur minimale est de 128 Ko et doit être définie par incréments de 64 Ko. Pour définir la taille par défaut de 4 Mo, définissez la valeur à D3D12XBOX_DEFAULT_SIZE_BYTES. pOffchipTessellationBuffer
Type : D3D12_GPU_VIRTUAL_ADDRESS
Spécifie l’adresse virtuelle d’une mémoire tampon où les facteurs de pavage sont stockés. Il peut s’agir d’un pointeur vers une mémoire tampon graphique de taille D3D12XBOX_OFFCHIP_TESSELLATION_BUFFER_SIZE, ou de 0 pour que le pilote en alloue une. GraphicsScratchMemorySizeBytes
Type : UINT
Spécifie la quantité de mémoire de travail à réserver pour les nuanceurs graphiques. Définissez-la à 0 ou, pour spécifier la taille par défaut de 16 Mo, à D3D12XBOX_DEFAULT_SIZE_BYTES. ComputeScratchMemorySizeBytes
Type : UINT
Spécifie la quantité de mémoire de travail à réserver pour les nuanceurs de calcul. Définissez-la à 0 ou, pour spécifier la taille par défaut de 16 Mo, à D3D12XBOX_DEFAULT_SIZE_BYTES. DisableGeometryShaderAllocations
Type : BOOL
Définissez à true pour désactiver les nuanceurs de géométrie (GS). Cela empêche l’utilisation des GS hors puce sur le périphérique et réduit l’utilisation de la mémoire en n’allouant pas de mémoires tampons circulaires GS. DisableTessellationShaderAllocations
Type : BOOL
Définissez à true pour désactiver le pavage, sur puce et hors puce. Cela empêche l’utilisation du pavage sur ce périphérique et réduit l’utilisation de la mémoire en n’allouant pas de mémoires tampons circulaires du paveur. DisableDXR
Type : BOOL
Définissez à true pour désactiver le lancer de rayons DirectX. Cela réduit l’utilisation de la mémoire en n’allouant pas les structures du pilote associées à la prise en charge du lancer de rayons. DisableAutomaticDPBBBreakBatchEvents
Type : BOOL
Empêche le pilote d’émettre automatiquement des événements d’interruption de lot pour le Deferred Primitive Batch Binning (DPBB). pDXRStackBuffer
Type : D3D12_GPU_VIRTUAL_ADDRESS
D3D12_GPU_VIRTUAL_ADDRESS_NULL (0) pour que le pilote effectue l’allocation, D3D12_GPU_VIRTUAL_ADDRESS_UNKNOWN (-1) pour ignorer l’allocation (utile lorsque seul le lancer de rayons en ligne est utilisé). Sinon, pointe vers une mémoire tampon de travail allouée par le titre pour les appels DispatchRays, et DXRStackBufferOverrideSizeBytes doit indiquer la taille de la mémoire tampon. DXRStackBufferOverrideSizeBytes
Type : UINT
Remplace l’allocation de la taille de pile DXR par défaut. Utilisez 0 pour la valeur par défaut du pilote. Si pDXRStackBuffer est défini, cette valeur doit indiquer la taille de cette allocation. CreateDeviceFlags
Type : D3D12XBOX_CREATE_DEVICE_FLAGS
Indicateurs de création du périphérique. AutoHDRPaperWhiteLevelNits
Type : UINT
Spécifie la luminance maximale du blanc, en nits, dans le contenu source qui est considérée comme non lumineuse. Des valeurs plus basses produisent des noirs plus profonds et un contraste plus élevé, des valeurs plus élevées produisent des noirs plus clairs et un contraste plus faible. Le paramètre peut être ajusté en fonction du contenu, mais la perception du noir dépend aussi des réglages du téléviseur et de l’éclairage ambiant de la pièce. Les valeurs typiques vont de 50 à 200 nits. Le définir à 0 fait en sorte que D3D utilise la valeur par défaut, ce qui est normalement recommandé. Ce paramètre n’a d’effet que lorsque la conversion HDR automatique est activée (D3D12XBOX_CREATE_DEVICE_FLAG_ENABLE_AUTO_HDR) et il est interdit de le spécifier lorsque la conversion n’est pas activée. DisableAutomaticCommandSegmentChaining
Type : BOOL
Désactive le chaînage automatique des segments de commandes. AmplificationShaderIndirectArgsBufferSize
Type : UINT
Définit la taille de la mémoire tampon d’arguments indirects utilisée pour les pipelines AS-MS dans l’API DispatchMesh. Le définir à D3D12XBOX_DEFAULT_SIZE_BYTES alloue actuellement une mémoire tampon de 64 Ko. Si vous n’utilisez pas de pipelines AS-MS, vous pouvez le définir à 0 pour empêcher toute allocation. Chaque groupe de threads AS lancé dans un appel DispatchMesh nécessite une structure D3D12XBOX_DISPATCH_MESH_X_ARGUMENTS. Si vous allouez moins que ce qu’exige votre appel DispatchMesh de taille maximale, le dessin sera divisé en lots pour tenir dans la mémoire tampon. AmplificationShaderPayloadBufferSize
Type : UINT
Définit la taille de la mémoire tampon de charge utile utilisée pour les pipelines AS-MS dans l’API DispatchMesh. Le définir à D3D12XBOX_DEFAULT_SIZE_BYTES alloue actuellement une mémoire tampon de 64 Ko. Si vous n’utilisez pas de pipelines AS-MS, vous pouvez le définir à 0 pour empêcher toute allocation.

Remarques

D3D12XboxCreateDevice utilise cette structure.

Configuration requise

En-tête : d3d12_xs.h
Plateformes prises en charge : consoles XBOX Series

Voir aussi

d3d12_xs
Last modified on October 6, 2026