estrutura D3DDDICB_SIGNALFLAGS (d3dukmdt.h)

Artigo
02/06/2025

A estrutura de D3DDDICB_SIGNALFLAGS descreve o comportamento de sinalização em uma chamada para as funções pfnSignalSynchronizationObjectCb ou pfnSignalSynchronizationObject2Cb.

Sintaxe

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;

Membros

SignalAtSubmission

Um valor UINT que especifica se um contexto deve sinalizar objetos de sincronização quando o pacote anteriormente enfileirado é enviado em vez de concluído (que é o comportamento padrão).

Definir esse membro é equivalente a definir o primeiro bit do membro Value de 32 bits (0x00000001).

EnqueueCpuEvent

Um valor UINT que modifica o comportamento da função pfnSignalSynchronizationObject2Cb.

Quando este membro é definido:

O evento especificado pelo CpuEventHandle membro da estrutura D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2 é sinalizado quando todos os contextos especificados em D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2 processam o comando de sinal.
Membros da estrutura D3DDDICB_SIGNALSYNCHRONIZATIONOBJECT2 à qual o parâmetro pfnSignalSynchronizationObject2CbpData pontos são restritos da seguinte maneira:
- ObjectCount deve ser zero.
- CpuEventHandle deve ser um identificador de evento válido.

Definir esse membro é equivalente a definir o segundo bit do membro de valor de 32 bits (0x00000002).

Com suporte a partir do Windows 8.

AllowFenceRewind

Um valor UINT que indica se um retrocesso de cerca intencional é permitido. Quando definido TRUE, a cerca pode ser rebobinada para uma cerca enfileirada que está atrás da atual.

Com suporte a partir do Windows 10 (WDDM 2.0).

Reserved

Esse membro é reservado e deve ser definido como zero.

DXGK_SIGNAL_FLAG_INTERNAL0

Esse membro é reservado e deve ser definido como zero.

Value

Um membro do sindicato contido em D3DDDICB_SIGNALFLAGS que pode conter um valor de 32 bits que identifica o comportamento de sinalização.