structure DXGK_SUBMITCOMMANDFLAGS (d3dkmddi.h)
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 tampon (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 ce paramètre équivaut à définir le premier bit du membre valeur 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 DxgkDdiPresent du pilote.
La définition de ce paramètre équivaut à définir le deuxième bit du membre valeur 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 à une allocation partagée qui appartient au Gestionnaire Windows d’affichage. La mémoire tampon DMA a été générée par la fonctionDxgkDdiRenderdu pilote.
La définition de ce paramètre équivaut à définir le troisième bit du membre valeur de 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 réellement exécuter (render) la mémoire tampon DMA. L’indicateur de champ binaire NullRendering est défini uniquement lors de l’examen et du débogage des performances pour simuler un moteur de rendu infiniment rapide qui doit toujours effectuer la surcharge de soumission et de signalisation de mémoire tampon DMA. NullRendering n’est jamais défini pendant les opérations classiques.
La définition de ce paramètre équivaut à définir le quatrième bit du membre valeur 32 bits (0x00000008).
Flip
[in] Valeur UINT qui spécifie si la mémoire tampon DMA contient une opération de retournement.
La définition de ce paramètre équivaut à définir le cinquième bit du membre valeur 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 prochaine synchronisation verticale.
La définition de ce paramètre équivaut à définir le sixième bit du membre valeur 32 bits (0x00000020).
ContextSwitch
[in] Prise en charge à partir de Windows 8.
Valeur UINT qui spécifie que le GPU doit passer du contexte en cours d’exécution 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 nulle avec le jeu de membres ContextSwitch.
Si le contexte actuel exécutait une opération qui a utilisé une mémoire tampon de pagination, la commande de commutateur de contexte est envoyée avec le membre pagination a également la valeur 1.
La définition de ce paramètre équivaut à définir le septième bit du membre Valeur 32 bits (0x00000040).
Resubmission
[in] Indique si ce paquet DMA est remis à nouveau au GPU en raison d’une préemption antérieure. Dans WDDM 2.0, les deux DXGKARG_SUBMITCOMMAND et DxgkDdiSubmitCommandVirtual auront cet indicateur défini sur zéro sur la première soumission de paquetS DMA et défini sur un paquet lorsqu’un paquet est resubmise en raison d’une préemption antérieure. L’indicateur est défini sur zéro dans WDDM 1.x, que le paquet ait déjà été préempté.
Prise 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 qui DXGK_SUBMITCOMMANDFLAGS contient une valeur 32 bits qui identifie les informations relatives à la mémoire tampon DMA.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista |
| d’en-tête | d3dkmddi.h (include D3dkmddi.h) |