Différences de Direct3D 12 : PC Windows et Game OS du GDK

​

Différences générales

• Le Game OS du Microsoft GDK prend en charge la sérialisation et la désérialisation des objets d’état de pipeline (PSO) afin d’éviter les coûts de construction des PSO à l’exécution dans le pilote. Cette fonctionnalité est la même que dans l’ERA. Le Game OS du Microsoft GDK accepte comme entrées valides les nuanceurs précompilés, les nuanceurs non précompilés, les nuanceurs dérivés et les PSO sérialisés. Nous recommandons d’utiliser des PSO sérialisés pour la vitesse, les économies d’espace et un meilleur contrôle par l’utilisateur.
• XBOX fournit de l’ESRAM, ce qui permet d’utiliser les mémoires tampons et les ressources de texture dans la mémoire la plus rapide possible. Maximiser l’utilisation de l’ESRAM est essentiel pour obtenir de hautes performances. Dans Gestion des ressources natives pour XBOX One, consultez la sous-section « Specifying Fast ESRAM Memory for a Buffer or Texture », et consultez Vue d’ensemble de la mémoire XG.
• Les files d’attente de commandes du Game OS du Microsoft GDK ne sont pas thread-safe. Il incombe au titre de synchroniser explicitement l’accès multithread aux files d’attente de commandes graphiques, de calcul et de copie/DMA. Sinon, les commandes émises dans la file d’attente risquent d’être corrompues, ce qui peut ensuite entraîner des blocages ou des plantages du GPU.
• Une seule file d’attente de commandes de chaque type peut être créée sur XBOX, sauf si l’extension CreateCommandQueueX est utilisée pour sélectionner explicitement un pipe/moteur et (pour le calcul) un index de file d’attente pour la file d’attente de commandes. Une seule file d’attente de commandes graphiques peut être créée, quelle que soit l’API utilisée. Une file d’attente de calcul ou de copie/DMA peut être créée par pipe/moteur GPU et index de file d’attente disponibles.
• Les barrières de ressources du Game OS du Microsoft GDK encouragent l’utilisation généralisée des transitions D3D12_RESOURCE_BARRIER_FLAG_BEGIN_ONLY et D3D12_RESOURCE_BARRIER_FLAG_END_ONLY, et il est recommandé de spécifier des indicateurs D3D12XBOX_RESOURCE_FLAG_PREFER* supplémentaires lors de la création de certains types de ressources (consultez D3D12_RESOURCE_FLAGS). Consultez la section « Barrières de ressources » ci-dessous, ainsi que D3D12_RESOURCE_BARRIER_FLAGS.
• Le Game OS du Microsoft GDK prend en charge un modèle de présentation différent du système d’appels Present de chaîne d’échange de Direct3D 12 sur PC. Pour en savoir plus sur le nouveau modèle de présentation, consultez Planification et présentation des images sur XBOX One.
• Le Game OS du Microsoft GDK encourage l’accès aux cibles de rendu multiéchantillonnées dans un état compressé pour des raisons de performance, et encourage également les ressources de profondeur/gabarit compressées. Dans la section Barrières de ressources ci-dessous, consultez Travailler directement avec des ressources compressées.
• Le Game OS du Microsoft GDK prend en charge un certain nombre d’extensions matérielles propres au GPU.
• Les extensions Direct3D 12.x du Game OS du Microsoft GDK fournissent les éléments suivants :
  • Types de tas de descripteurs supplémentaires
  • Manipulation directe des descripteurs
  • Composition de signatures racines et variantes de diffusion
  • Exécution asynchrone des listes de commandes (exécution avant la fermeture)
• Il incombe au titre de s’assurer que le GPU a terminé tous ses accès à une ressource avant de la détruire. Un titre doit insérer des clôtures (fences) à la fin des accès aux ressources et attendre que ces clôtures soient franchies avant de ramener à 0 le nombre de références des objets de ressource.
• Le Game OS du Microsoft GDK ne prend pas en charge l’utilisation du type de liste de commandes COPY (D3D12_COMMAND_LIST_TYPE_COPY) avec l’interface standard ID3D12GraphicsCommandList. Le Game OS du Microsoft GDK fournit plutôt une interface dédiée à la copie (ID3D12XboxDmaCommandList). Cette interface comprend la fonctionnalité de copie standard de ID3D12GraphicsCommandList ainsi que des extensions pour le matériel du moteur DMA de XBOX, comme la compression/décompression LZ et le décodage JPEG. Si vous prévoyez d’écrire du code multiplateforme pour les listes de commandes de copie Direct3D 12, nous recommandons d’utiliser un typedef pour l’interface de liste de commandes de copie, qui serait défini comme ID3D12XboxDmaCommandList sur le Game OS du Microsoft GDK et comme ID3D12GraphicsCommandList sur PC.

​

Pilotes de vente au détail, instrumentés et de débogage

• D3D12XboxSetProcessDebugFlags
• ID3D12Debug::SetProcessDebugFlags
• ID3D12Debug::EnableDebugLayer

​

Objets d’état de pipeline (PSO) hors ligne et dérivés

​

API pour les PSO hors ligne

• ID3D12Device::SerializeGraphicsPipelineStateX : Cette méthode sérialise un PSO afin de permettre un chargement efficace à l’exécution. Elle est destinée à être appelée dans le cadre d’un processus de création de contenu hors ligne, exécuté sur un PC (pris en charge par le pilote umd12_pc.dll ou xgs12_pc_xs.dll), et n’est pas destinée à être appelée pendant l’exécution d’un titre.
• ID3D12Device::DeserializeGraphicsPipelineStateX : Cette méthode désérialise (charge) un PSO graphique précédemment sérialisé. Cette méthode n’invoque jamais la compilation de nuanceurs à l’exécution, bien que dans de rares cas, elle génère une erreur indiquant que des PSO plus anciens doivent être recompilés.
• D3D12XBOX_SERIALIZE_SHADER : Cette structure contient des pointeurs vers les instructions GPU sérialisées du nuanceur et, éventuellement, vers des métadonnées sérialisées.
• D3D12XBOX_DESERIALIZE_SHADER : Cette structure contient des pointeurs vers les instructions GPU brutes désérialisées du nuanceur et vers les métadonnées désérialisées.
• D3D12XBOX_SERIALIZE_FLAGS : Cette énumération définit les indicateurs de sérialisation.
• D3D12XBOX_SERIALIZE_GRAPHICS_PIPELINE_STATE : Cette structure contient l’état de pipeline sérialisé.
• D3D12XBOX_DESERIALIZE_GRAPHICS_PIPELINE_STATE : Cette structure contient l’état de pipeline désérialisé.

​

PSO dérivés

• ID3D12Device::CreateDerivedGraphicsPipelineStateX : Cette méthode offre un moyen efficace de créer une variation d’un PSO graphique dérivée d’un PSO graphique source. Cette méthode garantit qu’aucune recompilation ni aucune correction de nuanceur n’est effectuée dans le cadre du processus de création.
• D3D12XBOX_DERIVED_GRAPHICS_STATE_TYPE : Cette énumération identifie l’état qui peut être modifié (profondeur/gabarit, rastérisation, fusion et masque d’échantillon).
• D3D12XBOX_DERIVED_GRAPHICS_STATE_DESC : Cette structure contient les descriptions du nouvel état requis.

​

Exemples illustrant les PSO hors ligne et les PSO dérivés

• Bokeh Effect
• Compute Particles
• Deferred Particles
• Draw Bundles
• Dynamic Cube Map
• ESRAM
• Mesh Rendering
• Simple Bezier
• Simple Instancing
• Simple Lighting
• Simple Triangle

​

Tas de descripteurs

​

Création de ressources

D3D12_RESOURCE_STATE_GENERIC_READ =
    D3D12_RESOURCE_STATE_VERTEX_AND_CONSTANT_BUFFER |
    D3D12_RESOURCE_STATE_INDEX_BUFFER |
    D3D12_RESOURCE_STATE_COPY_SOURCE |
    D3D12_RESOURCE_STATE_NON_PIXEL_SHADER_RESOURCE |
    D3D12_RESOURCE_STATE_PIXEL_SHADER_RESOURCE  

​

Barrières de ressources

• API pour les barrières de ressources
• Barrières de ressources lors des transitions d’utilisation
• Travailler directement avec des ressources compressées
• Barrières pour la transition entre des états d’utilisation qui incluent ou non l’accès en écriture

​

API pour les barrières de ressources

• ID3D12GraphicsCommandList::ResourceBarrier. Cette méthode avise le pilote qu’il doit synchroniser plusieurs accès aux ressources. Cette méthode est documentée en détail (pour une utilisation sur PC) sur Microsoft Docs : ID3D12GraphicsCommandList::ResourceBarrier. Les méthodes propres à XBOX de ID3D12GraphicsCommandList sont documentées dans le GDK.
• ID3D12XboxDmaCommandList::ResourceBarrier

​

Barrières de ressources lors des transitions d’utilisation

• D3D12XBOX_RESOURCE_FLAG_PREFER_INDEX_BUFFER
• D3D12XBOX_RESOURCE_FLAG_PREFER_INDIRECT_BUFFER
• D3D12XBOX_RESOURCE_FLAG_PREFER_PREDICATION_BUFFER
• D3D12XBOX_RESOURCE_FLAG_PREFER_STREAM_OUTPUT
• D3D12XBOX_RESOURCE_FLAG_DENY_COMPRESSION_DATA

​

Travailler directement avec des ressources compressées

• D3D12XBOX_RESOURCE_STATE_PRESERVE_COMPRESSED_COLOR
• D3D12XBOX_RESOURCE_STATE_PRESERVE_COMPRESSED_DEPTH
• D3D12XBOX_RESOURCE_STATE_PRESERVE_COMPRESSED_STENCIL
• D3D12XBOX_RESOURCE_STATE_PRESERVE_COMPRESSED_DEPTH_STENCIL
• D3D12XBOX_RESOURCE_STATE_PRESERVE_INDIRECT_COLOR_CLEAR
• D3D12XBOX_RESOURCE_STATE_PRESERVE_SCATTERED_COLOR_FMASK

• D3D12XBOX_RESOURCE_STATE_PRESERVE_EXPANDED_COLOR
• D3D12XBOX_RESOURCE_STATE_PRESERVE_EXPANDED_DEPTH
• D3D12XBOX_RESOURCE_STATE_PRESERVE_EXPANDED_STENCIL
• D3D12XBOX_RESOURCE_STATE_PRESERVE_EXPANDED_DEPTH_STENCIL

​

Barrières pour la transition entre des états d’utilisation qui incluent ou non l’accès en écriture

1. D3D12_RESOURCE_BARRIER_FLAG_BEGIN_ONLY est utilisé pour amorcer une transition de barrière vers un nouvel état (sans la terminer), ce qui la place dans une condition temporaire sans accès.
2. Ajoutez le travail indépendant à la liste de commandes.
3. D3D12_RESOURCE_BARRIER_FLAG_END_ONLY est utilisé dans un appel ResourceBarrier subséquent pour terminer la transition et passer de la condition temporaire sans accès et de l’ancien état à un accès actif dans le nouvel état.

​

Différences d’alignement

​

Voir aussi