estrutura D3DDDI_SYNCHRONIZATIONOBJECTINFO2 (d3dukmdt.h)

Artigo
10/23/2024

A estrutura D3DDDI_SYNCHRONIZATIONOBJECTINFO2 contém informações sobre um objeto de sincronização de segunda geração.

Sintaxe

typedef struct _D3DDDI_SYNCHRONIZATIONOBJECTINFO2 {
  D3DDDI_SYNCHRONIZATIONOBJECT_TYPE  Type;
  D3DDDI_SYNCHRONIZATIONOBJECT_FLAGS Flags;
  union {
    struct {
      BOOL InitialState;
    } SynchronizationMutex;
    struct {
      UINT MaxCount;
      UINT InitialCount;
    } Semaphore;
    struct {
      D3DKMT_ALIGN64 UINT64 FenceValue;
    } Fence;
    struct {
      HANDLE Event;
    } CPUNotification;
    struct {
      D3DKMT_ALIGN64 UINT64                 InitialFenceValue;
      VOID                                  *FenceValueCPUVirtualAddress;
      D3DKMT_ALIGN64 D3DGPU_VIRTUAL_ADDRESS FenceValueGPUVirtualAddress;
      UINT                                  EngineAffinity;
      UINT                                  Padding;
    } MonitoredFence;
    struct {
      D3DKMT_HANDLE                         hAdapter;
      D3DDDI_VIDEO_PRESENT_TARGET_ID        VidPnTargetId;
      D3DKMT_ALIGN64 UINT64                 Time;
      VOID                                  *FenceValueCPUVirtualAddress;
      D3DKMT_ALIGN64 D3DGPU_VIRTUAL_ADDRESS FenceValueGPUVirtualAddress;
      UINT                                  EngineAffinity;
      UINT                                  Padding;
    } PeriodicMonitoredFence;
    struct {
      D3DKMT_ALIGN64 UINT64 Reserved[8];
    } Reserved;
  };
  D3DKMT_HANDLE                      SharedHandle;
} D3DDDI_SYNCHRONIZATIONOBJECTINFO2;

Membros

Type

[in] Um valor do tipo D3DDDI_SYNCHRONIZATIONOBJECT_TYPE que indica o tipo de objeto de sincronização.

Flags

[in] Uma estrutura D3DDDI_SYNCHRONIZATIONOBJECT_FLAGS que especifica, em sinalizadores de campo de bit, atributos do objeto de sincronização.

SynchronizationMutex

Uma estrutura que contém informações sobre um mutex de sincronização. Se o membro tipo for igual a D3DDDI_SYNCHRONIZATION_MUTEX, a união em D3DDDI_SYNCHRONIZATIONOBJECTINFO2 manterá uma estrutura SynchronizationMutex .

SynchronizationMutex.InitialState

Um valor booliano que indica se o mutex de sincronização pertence inicialmente a um objeto. Um valor de TRUE indica que o mutex é de propriedade; FALSE indica que o mutex não é de propriedade.

Semaphore

Uma estrutura que contém informações sobre um semáforo. Se o membro tipo for igual a D3DDDI_SEMAPHORE, a união em D3DDDI_SYNCHRONIZATIONOBJECTINFO2 manterá uma estrutura de Semáforo .

Semaphore.MaxCount

O número máximo de eventos que um objeto pode estar aguardando.

Semaphore.InitialCount

O número inicial de eventos que um objeto está aguardando.

Fence

Uma estrutura que contém informações sobre uma cerca. Se o membro tipo for igual a D3DDDI_FENCE, o sindicato em D3DDDI_SYNCHRONIZATIONOBJECTINFO2 manterá uma estrutura Fence.

Fence.FenceValue

Um valor de 64 bits que especifica o valor de cerca inicial.

CPUNotification

Uma estrutura que contém informações sobre uma notificação de CPU. Se o membro tipo for igual a D3DDDI_CPU_NOTIFICATION, a união em D3DDDI_SYNCHRONIZATIONOBJECTINFO2 manterá uma estrutura CPUNotification.

CPUNotification.Event

O identificador do evento de notificação da CPU.

MonitoredFence

Uma estrutura que contém informações sobre uma cerca monitorada. Se o membro tipo for igual a D3DDDI_MONITORED_FENCE, a união em D3DDDI_SYNCHRONIZATIONOBJECTINFO2 manterá uma estrutura MonitoredFence.

As cercas monitoradas só podem ser compartilhadas usando identificadores NT por motivos de segurança, portanto, o sinalizador de NtSecuritySharing do deve ser definido ao usar uma cerca monitorada.