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	Combinaison des deux indications ci-dessus

Notes

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 d’API D3D12 permettant d’effacer ou de 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é ; dans ce 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/copie est sérialisé sur le GPU. L’impact sur les performances de cette approche prudente du pilote peut être important, en particulier lorsque l’application souhaite effacer/copier de nombreuses ressources à la suite. Dans de nombreux cas, la synchronisation peut être omise sans risque, 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 lors de l’appel Clear/Copy pendant l’appel à DriverHintX, afin d’amortir le coût pour de longues séquences d’effacements/copies. L’utilisation attendue 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

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

Syntaxe

Constantes

Notes

Configuration requise

Voir aussi

​Syntaxe

​Constantes

​Notes

​Configuration requise

​Voir aussi

Syntaxe

Constantes

Notes

Configuration requise

Voir aussi