struttura D3DDDI_SYNCHRONIZATIONOBJECTINFO2 (d3dukmdt.h)

Articolo
10/23/2024

La struttura D3DDDI_SYNCHRONIZATIONOBJECTINFO2 contiene informazioni su un oggetto di sincronizzazione di seconda generazione.

Sintassi

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;

Membri

Type

[in] Valore di tipo D3DDDI_SYNCHRONIZATIONOBJECT_TYPE che indica il tipo di oggetto di sincronizzazione.

Flags

[in] Struttura D3DDDI_SYNCHRONIZATIONOBJECT_FLAGS che specifica, in flag di campo di bit, attributi dell'oggetto di sincronizzazione.

SynchronizationMutex

Struttura che contiene informazioni su un mutex di sincronizzazione. Se il membro type è uguale a D3DDDI_SYNCHRONIZATION_MUTEX, l'unione in D3DDDI_SYNCHRONIZATIONOBJECTINFO2 contiene una struttura SynchronizationMutex.

SynchronizationMutex.InitialState

Valore booleano che indica se il mutex di sincronizzazione è inizialmente di proprietà di un oggetto . Un valore TRUE indica che il mutex è di proprietà; FALSE indica che il mutex non è di proprietà.

Semaphore

Struttura che contiene informazioni su un semaforo. Se il membro type è uguale a D3DDDI_SEMAPHORE, l'unione in D3DDDI_SYNCHRONIZATIONOBJECTINFO2 contiene una struttura semaforo.

Semaphore.MaxCount

Numero massimo di eventi che un oggetto può attendere.

Semaphore.InitialCount

Numero iniziale di eventi in attesa di un oggetto.

Fence

Struttura che contiene informazioni su un recinto. Se il membro Type è uguale a D3DDDI_FENCE, l'unione in D3DDDI_SYNCHRONIZATIONOBJECTINFO2 contiene una struttura di di isolamento.

Fence.FenceValue

Valore a 64 bit che specifica il valore di limite iniziale.

CPUNotification

Struttura che contiene informazioni su una notifica della CPU. Se il membro Type è uguale a D3DDDI_CPU_NOTIFICATION, l'unione in D3DDDI_SYNCHRONIZATIONOBJECTINFO2 contiene una struttura CPUNotification.

CPUNotification.Event

Handle per l'evento di notifica della CPU.

MonitoredFence

Struttura che contiene informazioni su un recinto monitorato. Se il membro Type è uguale a D3DDDI_MONITORED_FENCE, l'unione in D3DDDI_SYNCHRONIZATIONOBJECTINFO2 contiene una struttura MonitoredFence.

I recinti monitorati possono essere condivisi solo usando handle NT per motivi di sicurezza, pertanto il flag NtSecuritySharing deve essere impostato quando si usa un recinto monitorato.