structure D3DDDICB_SIGNALFLAGS (d3dukmdt.h)

Article
02/06/2025

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 des objets de synchronisation lorsque le paquet précédemment mis en file d’attente est envoyé plutôt que terminé (qui est le comportement par défaut).

La définition de ce membre équivaut à définir le premier bit du membre valeur de 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 traiter la commande de signal.
Les membres de la structure D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2 dont les points de paramètre pData de la fonction pfnSignalSynchronizationObject2 Cb sont limités comme suit :
- ObjectCount doit être égal à zéro.
- CpuEventHandle doit être un handle d’événement valide.

La définition de ce membre équivaut à définir le deuxième bit du membre valeur 32 bits (0x00000002).

Prise en charge à partir de Windows 8.

AllowFenceRewind

Valeur UINT qui indique si un rembobinage intentionnel est autorisé. Lorsqu’elle est définie sur TRUE, la clôture peut être rewound à une clôture en file d’attente qui se trouve derrière la clôture actuelle.

Prise 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 contenue dans D3DDDICB_SIGNALFLAGS qui peut contenir une valeur 32 bits qui identifie le comportement de signalisation.