D3DDDI_SYNCHRONIZATIONOBJECTINFO2 Struktur (d3dukmdt.h)

Artikel
10/23/2024

Die D3DDDI_SYNCHRONIZATIONOBJECTINFO2-Struktur enthält Informationen zu einem Synchronisierungsobjekt der zweiten Generation.

Syntax

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;

Angehörige

Type

[in] Ein Wert vom Typ D3DDDI_SYNCHRONIZATIONOBJECT_TYPE, der den Typ des Synchronisierungsobjekts angibt.

Flags

[in] Eine D3DDDI_SYNCHRONIZATIONOBJECT_FLAGS Struktur, die Attribute des Synchronisierungsobjekts in Bitfeldkennzeichnungen angibt.

SynchronizationMutex

Eine Struktur, die Informationen zu einem Synchronisierungsmutex enthält. Wenn der Type Member gleich D3DDDI_SYNCHRONIZATION_MUTEXist, enthält die Union in D3DDDI_SYNCHRONIZATIONOBJECTINFO2 eine SynchronizationMutex- Struktur.

SynchronizationMutex.InitialState

Ein boolescher Wert, der angibt, ob der Synchronisierungsmutex anfänglich einem Objekt gehört. Ein Wert von TRUE gibt an, dass der Mutex im Besitz ist; FALSE gibt an, dass der Mutex nicht im Besitz ist.

Semaphore

Eine Struktur, die Informationen zu einem Semaphor enthält. Wenn das Typ--Mitglied D3DDDI_SEMAPHOREentspricht, enthält die Vereinigung in D3DDDI_SYNCHRONIZATIONOBJECTINFO2 eine Semaphor- Struktur.

Semaphore.MaxCount

Die maximale Anzahl von Ereignissen, auf die ein Objekt warten kann.

Semaphore.InitialCount

Die anfängliche Anzahl von Ereignissen, auf die ein Objekt wartet.

Fence

Eine Struktur, die Informationen zu einem Zaun enthält. Wenn der Typ- Mitglied gleich D3DDDI_FENCEist, enthält die Vereinigung in D3DDDI_SYNCHRONIZATIONOBJECTINFO2 eine Zaun Struktur.

Fence.FenceValue

Ein 64-Bit-Wert, der den anfänglichen Zaunwert angibt.

CPUNotification

Eine Struktur, die Informationen zu einer CPU-Benachrichtigung enthält. Wenn der Typ--Member D3DDDI_CPU_NOTIFICATIONentspricht, enthält die Union in D3DDDI_SYNCHRONIZATIONOBJECTINFO2 eine CPUNotification- Struktur.

CPUNotification.Event

Das Handle für das CPU-Benachrichtigungsereignis.

MonitoredFence

Eine Struktur, die Informationen zu einem überwachten Zaun enthält. Wenn der Typ--Mitglied D3DDDI_MONITORED_FENCEentspricht, enthält die Vereinigung in D3DDDI_SYNCHRONIZATIONOBJECTINFO2 eine MonitoredFence- Struktur.

Überwachte Zäune können nur mithilfe von NT-Handles aus Sicherheitsgründen gemeinsam genutzt werden, sodass das NtSecuritySharing- Flag bei Verwendung eines überwachten Zauns festgelegt werden muss.