DXGK_SUBMITCOMMANDFLAGS structure (d3dkmddi.h)

  • Article

La structure DXGK_SUBMITCOMMANDFLAGS identifie, dans les indicateurs de champ binaire, des informations sur une mémoire tampon d’accès direct à la mémoire (DMA) à soumettre à l’unité de traitement graphique (GPU).

Syntaxe

typedef struct _DXGK_SUBMITCOMMANDFLAGS {
  union {
    struct {
      UINT Paging : 1;
      UINT Present : 1;
      UINT RedirectedPresent : 1;
      UINT NullRendering : 1;
      UINT Flip : 1;
      UINT FlipWithNoWait : 1;
      UINT ContextSwitch : 1;
      UINT Resubmission : 1;
      UINT VirtualMachineData : 1;
#if ...
      UINT Reserved : 23;
#elif
      UINT Reserved : 24;
#elif
      UINT Reserved : 25;
#else
      UINT Reserved : 26;
#endif
    };
    UINT Value;
  };
} DXGK_SUBMITCOMMANDFLAGS;

Membres

Paging

[in] Valeur UINT qui spécifie si la mémoire tampon DMA est une mémoire tampon de pagination, qui contient des opérations de pagination.

La définition de cette valeur revient à définir le premier bit du membre value 32 bits (0x00000001).

Present

[in] Valeur UINT qui spécifie si la mémoire tampon DMA contient une opération actuelle. La mémoire tampon DMA a été générée par la fonction DxgkDdiPresentdu pilote.

Définir cela revient à définir le deuxième bit du membre Value 32 bits (0x00000002).

RedirectedPresent

[in] Valeur UINT qui spécifie si la mémoire tampon DMA contient une opération actuelle redirigée, qui est un présent vers une allocation partagée qui appartient au Gestionnaire Windows d’affichage. La mémoire tampon DMA a été générée par la fonction DxgkDdiRender du pilote.

Définir cela revient à définir le troisième bit du membre Valeur 32 bits (0x00000004).

NullRendering

[in] Valeur UINT qui spécifie si le pilote doit simuler l’insertion de la mémoire tampon DMA dans l’anneau (autrement dit, si le pilote doit générer l’interruption de clôture à la fin de la mémoire tampon DMA) ; Toutefois, le pilote ne doit pas exécuter (restituer) la mémoire tampon DMA. L’indicateur de champ de bits NullRendering est défini uniquement pendant l’examen et le débogage des performances pour simuler un moteur de rendu infiniment rapide qui doit toujours effectuer la surcharge de soumission et de signalisation de la mémoire tampon DMA. NullRendering n’est jamais défini pendant les opérations classiques.

Définir cela revient à définir le quatrième bit du membre Value 32 bits (0x00000008).

Flip

[in] Valeur UINT qui spécifie si la mémoire tampon DMA contient une opération de retournement.

Cette définition revient à définir le cinquième bit du membre Value 32 bits (0x00000010).

FlipWithNoWait

[in] Valeur UINT qui spécifie si la mémoire tampon DMA contient une opération de retournement qui se produit sans attendre la synchronisation verticale suivante.

Définir cela revient à définir le sixième bit du membre Value 32 bits (0x00000020).

ContextSwitch

[in] Pris en charge à partir de Windows 8.

Valeur UINT qui spécifie que le GPU doit passer du contexte d’exécution actuel au contexte Null.

À compter de Windows 8, le système d’exploitation demande explicitement au GPU de basculer vers le contexte null chaque fois qu’une tentative est effectuée pour déplacer ou supprimer une ressource qui appartient au contexte en cours d’exécution sur le GPU. La demande de commutateur de contexte est effectuée en envoyant une mémoire tampon DMA de longueur zéro avec le jeu de membres ContextSwitch .

Si le contexte actuel exécutait une opération qui utilisait une mémoire tampon de pagination, la commande de commutateur de contexte est envoyée avec le membre Paging également défini sur un.

La définition de cette valeur revient à définir le septième bit du membre Value 32 bits (0x00000040).

Resubmission

[in] Indique si ce paquet DMA est à nouveau soumis au GPU en raison d’une préemption antérieure. Dans WDDM 2.0, DXGKARG_SUBMITCOMMAND et DxgkDdiSubmitCommandVirtual ont cet indicateur défini sur zéro lors de la première soumission de paquets DMA, et défini sur un lorsque un paquet est à nouveau soumis en raison d’une préemption antérieure. L’indicateur est défini sur zéro dans WDDM 1.x, qu’un paquet ait été préempté ou non.

Pris en charge à partir de Windows 10.

VirtualMachineData

[in] Indique que la soumission provient d’un adaptateur paravirtualisé.

Reserved

[in] Ce membre est réservé et doit être défini sur zéro.

Value

[in] Membre de l’union que contient DXGK_SUBMITCOMMANDFLAGS qui peut contenir une valeur 32 bits qui identifie des informations sur la mémoire tampon DMA.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista
En-tête d3dkmddi.h (include D3dkmddi.h)

Voir aussi

DXGKARG_SUBMITCOMMAND

DxgkDdiSubmitCommand