D3DDDI_SYNCHRONIZATIONOBJECTINFO2 struttura (d3dukmdt.h)

Articolo
04/16/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 {
      void D3DKMT_PTR(
    HANDLE unnamedParam1,
    Event  unnamedParam2
  );
    } CPUNotification;
    struct {
      D3DKMT_ALIGN64 UINT64                 InitialFenceValue;
      void                                  D3DKMT_PTR(
    VOID                        *unnamedParam1,
    FenceValueCPUVirtualAddress unnamedParam2
  );
      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                                  D3DKMT_PTR(
    VOID                        *unnamedParam1,
    FenceValueCPUVirtualAddress unnamedParam2
  );
      D3DKMT_ALIGN64 D3DGPU_VIRTUAL_ADDRESS FenceValueGPUVirtualAddress;
      UINT                                  EngineAffinity;
      UINT                                  Padding;
    } PeriodicMonitoredFence;
    struct {
      D3DKMT_ALIGN64 UINT64 Reserved[8];
    } Reserved;
  };
  D3DKMT_HANDLE                      SharedHandle;
} D3DDDI_SYNCHRONIZATIONOBJECTINFO2;

Members

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 a 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 SyncMutex .

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 di 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 recinzione .

Fence.FenceValue

Valore a 64 bit che specifica il valore iniziale del recinto.

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 .

void D3DKMT_PTR( HANDLE unnamedParam1, Event unnamedParam2)

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 MonitorFence .

Le recinzioni monitorate possono essere condivise solo usando handle NT per motivi di sicurezza, pertanto il flag NtSecuritySharing deve essere impostato quando si usa una recinzione monitorata.