D3DDDICB_SIGNALFLAGS structure (d3dukmdt.h)

Article
02/23/2024

La structure D3DDDICB_SIGNALFLAGS décrit le comportement de signalisation dans un appel aux fonctions pfnSignalSynchronizationObjectCb ou pfnSignalSynchronizationObject2Cb .

Syntaxe

typedef struct _D3DDDICB_SIGNALFLAGS {
  union {
    struct {
      UINT SignalAtSubmission : 1;
      UINT EnqueueCpuEvent : 1;
      UINT AllowFenceRewind : 1;
#if ...
      UINT Reserved : 28;
      UINT DXGK_SIGNAL_FLAG_INTERNAL0 : 1;
#elif
      UINT Reserved : 30;
#else
      UINT Reserved : 31;
#endif
    };
    UINT Value;
  };
} D3DDDICB_SIGNALFLAGS;

Membres

SignalAtSubmission

Valeur UINT qui spécifie si un contexte doit signaler les objets de synchronisation lorsque le paquet précédemment mis en file d’attente est envoyé plutôt que terminé (ce qui est le comportement par défaut).

Définir ce membre revient à définir le premier bit du membre Value 32 bits (0x00000001).

EnqueueCpuEvent

Valeur UINT qui modifie le comportement de la fonction pfnSignalSynchronizationObject2Cb .

Lorsque ce membre est défini :

L’événement spécifié par le membre CpuEventHandle de la structure D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2 est signalé lorsque tous les contextes spécifiés dans D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2 traitent la commande signal.
Les membres de la structure D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2 vers laquelle pointe le paramètre pData de la fonction pfnSignalSynchronizationObject2Cb sont limités comme suit :
- ObjectCount doit être égal à zéro.
- CpuEventHandle doit être un handle d’événement valide.

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

Pris en charge à partir de Windows 8.

AllowFenceRewind

Valeur UINT qui indique si un rembobinage intentionnel de clôture est autorisé. Lorsque la valeur EST TRUE, la clôture peut être rembobinée sur une clôture mise en file d’attente qui se trouve derrière la clôture actuelle.

Pris en charge à partir de Windows 10 (WDDM 2.0).

Reserved

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

DXGK_SIGNAL_FLAG_INTERNAL0

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

Value

Membre de l’union contenu dans D3DDDICB_SIGNALFLAGS pouvant contenir une valeur 32 bits qui identifie le comportement de signalisation.