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/désérialisation des objets d’état de pipeline (PSO) afin d’éviter les coûts de construction des PSO au moment de l’exécution dans le pilote. Cette fonctionnalité est identique à celle de l’ERA. Le Game OS du Microsoft GDK accepte comme entrées valides les shaders précompilés, les shaders non précompilés, les shaders dérivés et les PSO sérialisés. Nous recommandons d’utiliser des PSO sérialisés pour la rapidité, le gain d’espace et un meilleur contrôle par l’utilisateur.
• XBOX fournit de l’ESRAM, ce qui permet d’utiliser les ressources de tampons et de textures dans la mémoire la plus rapide possible. Maximiser l’utilisation de l’ESRAM est essentiel pour obtenir des performances élevées. Dans Gestion native des ressources 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. À défaut, les commandes émises dans la file d’attente risquent d’être corrompues, ce qui peut 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 une 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 (voir 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 de 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 performances, et encourage également les ressources de profondeur/stencil compressées. Dans la section Barrières de ressources ci-dessous, consultez Utilisation directe 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 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 fences à la fin des accès aux ressources et attendre que ces fences soient franchies avant de ramener à 0 le nombre de références des objets ressources.
• 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 inclut la fonctionnalité de copie standard de ID3D12GraphicsCommandList ainsi que des extensions pour le matériel du moteur DMA XBOX, telles que 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 vous recommandons d’utiliser un typedef pour l’interface de liste de commandes de copie, défini comme ID3D12XboxDmaCommandList sur le Game OS du Microsoft GDK et comme ID3D12GraphicsCommandList sur PC.

​

Pilotes retail, instrumenté et de débogage

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

​

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

​

API pour les PSO hors connexion

• ID3D12Device::SerializeGraphicsPipelineStateX : cette méthode sérialise un PSO afin de permettre un chargement efficace au moment de l’exécution. Elle est destinée à être appelée dans le cadre d’un processus de création de contenu hors connexion, 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 ne déclenche jamais de compilation de shaders au moment de l’exécution, bien que, dans de rares cas, elle génère une erreur indiquant que d’anciens PSO doivent être recompilés.
• D3D12XBOX_SERIALIZE_SHADER : cette structure contient des pointeurs vers les instructions GPU sérialisées du shader et éventuellement 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 shader et 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 variante d’un PSO graphique dérivée d’un PSO graphique source. Cette méthode garantit qu’aucune recompilation ni aucun correctif de shader n’est effectué lors du processus de création.
• D3D12XBOX_DERIVED_GRAPHICS_STATE_TYPE : cette énumération identifie l’état qui peut être modifié (profondeur/stencil, 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 connexion 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
• Utilisation directe des ressources compressées
• Barrières pour les transitions 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 indique au 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

​

Utilisation directe 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 les transitions entre des états d’utilisation qui incluent ou non l’accès en écriture

1. D3D12_RESOURCE_BARRIER_FLAG_BEGIN_ONLY est utilisé pour démarrer une transition de barrière vers un nouvel état (sans la terminer), ce qui place la ressource 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 ultérieur 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