D3D12XBOX_CMDLIST_DRIVER_HINT (consoles XBOX Series)

Indications passées à une liste de commandes afin de modifier le comportement interne du pilote. À utiliser avec l’API de liste de commandes DriverHintX.

Syntaxe

enum D3D12XBOX_CMDLIST_DRIVER_HINT    
{  
    D3D12XBOX_CMDLIST_DRIVER_HINT_BEGIN_ALTERNATIVE_COMPUTE_PSO_RENDERING,  
    D3D12XBOX_CMDLIST_DRIVER_HINT_END_ALTERNATIVE_COMPUTE_PSO_RENDERING,
    D3D12XBOX_CMDLIST_DRIVER_HINT_DONT_SYNC_ON_CLEAR,
    D3D12XBOX_CMDLIST_DRIVER_HINT_DONT_SYNC_ON_COPY,
    D3D12XBOX_CMDLIST_DRIVER_HINT_DONT_SYNC_ON_CLEAR_OR_COPY  
}  

Constantes

Constante	Description
D3D12XBOX_CMDLIST_DRIVER_HINT_BEGIN_ALTERNATIVE_COMPUTE_PSO_RENDERING	Usage interne uniquement
D3D12XBOX_CMDLIST_DRIVER_HINT_END_ALTERNATIVE_COMPUTE_PSO_RENDERING	Usage interne uniquement
D3D12XBOX_CMDLIST_DRIVER_HINT_DONT_SYNC_ON_CLEAR	Si elle est appliquée, le pilote n’insère aucune synchronisation de pipeline ni aucun vidage de cache pendant les opérations d’effacement
D3D12XBOX_CMDLIST_DRIVER_HINT_DONT_SYNC_ON_COPY	Si elle est appliquée, le pilote n’insère aucune synchronisation de pipeline ni aucun vidage de cache pendant les opérations de copie
D3D12XBOX_CMDLIST_DRIVER_HINT_DONT_SYNC_ON_CLEAR_OR_COPY	La combinaison des deux indications ci-dessus

Remarques

D3D12XBOX_CMDLIST_DRIVER_HINT_DONT_SYNC_ON_CLEAR
D3D12XBOX_CMDLIST_DRIVER_HINT_DONT_SYNC_ON_COPY
D3D12XBOX_CMDLIST_DRIVER_HINT_DONT_SYNC_ON_CLEAR_OR_COPY

Les appels de l’API D3D12 visant à effacer ou à copier des ressources nécessitent en interne une synchronisation pour garantir l’exactitude en raison des risques de lecture après écriture (RAW, Read After Write). Par exemple, le pilote peut choisir d’effectuer l’effacement d’une cible de rendu à l’aide d’une opération Dispatch pour des raisons d’efficacité, auquel cas tout travail de nuanceur de pixels en attente doit être vidé, car le pilote ne sait pas si des dessins en cours écrivent dans la cible de rendu en question; le résultat final est que tout le travail d’effacement et de copie est sérialisé sur le GPU. L’incidence sur les performances de la prudence dont doit faire preuve le pilote peut être importante, en particulier lorsque l’application souhaite effacer ou copier de nombreuses ressources à la suite. Dans de nombreux cas, la synchronisation peut être omise en toute sécurité, car le développeur de l’application sait que le risque RAW n’est pas présent dans son scénario particulier. Dans ce cas, l’application peut utiliser les indications ci-dessus pour placer la liste de commandes dans un mode où le pilote n’insère pas la synchronisation dans le flux de commandes. L’appel de l’API d’indication avec l’un de ces indicateurs dans le champ feature et une valeur non nulle dans le champ value place la liste de commandes en « mode sans synchronisation »; à l’inverse, une valeur de 0 rétablit le fonctionnement normal de la liste de commandes. Les listes de commandes reviennent également au fonctionnement normal lors des appels à Reset. Le pilote insère la synchronisation qu’il insérerait habituellement pendant l’appel d’effacement ou de copie lors de l’appel à DriverHintX, afin de permettre l’amortissement du coût pour de longues séquences d’effacements ou de copies. L’utilisation prévue est la suivante :

    pList->DriverHintX(D3D12XBOX_CMDLIST_DRIVER_HINT_DONT_SYNC_ON_CLEAR_OR_COPY, 1); // Driver will synchronize here
        pList->ClearRenderTargetView(...);
        pList->ClearRenderTargetView(...);
        pList->ClearDepthStencilView(...);
        pList->CopyResource(...);
        etc
    pList->DriverHintX(D3D12XBOX_CMDLIST_DRIVER_HINT_DONT_SYNC_ON_CLEAR_OR_COPY, 0); // Driver also synchronize here, safe to use clear/copied resources without hazard

Configuration requise

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

Voir aussi

d3d12_xs

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

Syntaxe

Constantes

Remarques

Configuration requise

Voir aussi

​Syntaxe

​Constantes

​Remarques

​Configuration requise

​Voir aussi

Syntaxe

Constantes

Remarques

Configuration requise

Voir aussi