D3DDDI_SYNCHRONIZATIONOBJECTINFO2 structure (d3dukmdt.h)

Article
04/16/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 {
      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;

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

Fence.FenceValue

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

CPUNotification

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

void D3DKMT_PTR( HANDLE unnamedParam1, Event unnamedParam2)

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

Les clôtures surveillées ne peuvent être partagées qu’à l’aide de handles NT pour des raisons de sécurité. L’indicateur NtSecuritySharing doit donc être défini lors de l’utilisation d’une clôture surveillée.