structure D3DDDI_SYNCHRONIZATIONOBJECTINFO2 (d3dukmdt.h)

Article
10/23/2024

La structure D3DDDI_SYNCHRONIZATIONOBJECTINFO2 contient des informations sur un objet de synchronisation de deuxième génération.

Syntaxe

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;

Membres

Type

[in] Valeur de type D3DDDI_SYNCHRONIZATIONOBJECT_TYPE qui indique le type d’objet de synchronisation.

Flags

[in] Structure D3DDDI_SYNCHRONIZATIONOBJECT_FLAGS qui spécifie, dans les indicateurs de champ binaire, les attributs de l’objet de synchronisation.

SynchronizationMutex

Structure qui contient des informations sur un mutex de synchronisation. Si le membre type est égal à D3DDDI_SYNCHRONIZATION_MUTEX, l’union dans D3DDDI_SYNCHRONIZATIONOBJECTINFO2 contient une structure SynchronizationMutex.

SynchronizationMutex.InitialState

Valeur booléenne qui indique si le mutex de synchronisation appartient initialement à un objet. La valeur TRUE indique que le mutex est détenu ; FALSE indique que le mutex n’est pas détenu.

Semaphore

Structure qui contient des informations sur un sémaphore. Si le membre type est égal à D3DDDI_SEMAPHORE, l’union dans D3DDDI_SYNCHRONIZATIONOBJECTINFO2 contient une structure sémaphore.

Semaphore.MaxCount

Nombre maximal d’événements qu’un objet peut attendre.

Semaphore.InitialCount

Nombre initial d’événements qu’un objet attend.

Fence

Structure qui contient des informations sur une clôture. Si le membre type est égal à D3DDDI_FENCE, l’union dans D3DDDI_SYNCHRONIZATIONOBJECTINFO2 contient une structure de clôture .

Fence.FenceValue

Valeur 64 bits qui spécifie la valeur de clôture initiale.

CPUNotification

Structure qui contient des informations sur une notification processeur. Si le membre type est égal à D3DDDI_CPU_NOTIFICATION, l’union dans D3DDDI_SYNCHRONIZATIONOBJECTINFO2 contient une structure CPUNotification.

CPUNotification.Event

Handle de l’événement de notification du processeur.

MonitoredFence

Structure qui contient des informations sur une clôture surveillée. Si le membre type est égal à D3DDDI_MONITORED_FENCE, l’union dans D3DDDI_SYNCHRONIZATIONOBJECTINFO2 contient une structure MonitorFence.

Les clôtures surveillées peuvent être partagées uniquement à l’aide de poignées NT pour des raisons de sécurité. Par conséquent, l’indicateur de de partage NtSecuritySharing doit être défini lors de l’utilisation d’une clôture surveillée.