структура D3DDDI_SYNCHRONIZATIONOBJECTINFO2 (d3dukmdt.h)

Статья
04/12/2024

Структура D3DDDI_SYNCHRONIZATIONOBJECTINFO2 содержит сведения об объекте синхронизации второго поколения.

Синтаксис

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;

Члены

Type

[in] Значение типа D3DDDI_SYNCHRONIZATIONOBJECT_TYPE , указывающее тип объекта синхронизации.

Flags

[in] Структура D3DDDI_SYNCHRONIZATIONOBJECT_FLAGS , указывающая в флагах битовых полей атрибуты объекта синхронизации.

SynchronizationMutex

Структура, содержащая сведения о мьютексе синхронизации. Если элемент Type равен D3DDDI_SYNCHRONIZATION_MUTEX, объединение в D3DDDI_SYNCHRONIZATIONOBJECTINFO2 содержит структуру SynchronizationMutex .

SynchronizationMutex.InitialState

Логическое значение, указывающее, принадлежит ли мьютекс синхронизации объекту. Значение TRUE указывает, что мьютекс принадлежит; FALSE указывает, что мьютекс не принадлежит.

Semaphore

Структура, содержащая сведения о семафоре. Если элемент Type равен D3DDDI_SEMAPHORE, объединение в D3DDDI_SYNCHRONIZATIONOBJECTINFO2 содержит структуру семафора .

Semaphore.MaxCount

Максимальное количество событий, которое может ожидать объект.

Semaphore.InitialCount

Начальное число событий, ожидающих объекта.

Fence

Структура, содержащая сведения о заборе. Если элемент Type равен D3DDDI_FENCE, объединение в D3DDDI_SYNCHRONIZATIONOBJECTINFO2 содержит структуру Fence .

Fence.FenceValue

64-разрядное значение, указывающее начальное значение ограждения.

CPUNotification

Структура, содержащая сведения об уведомлении ЦП. Если элемент Type равен D3DDDI_CPU_NOTIFICATION, объединение в D3DDDI_SYNCHRONIZATIONOBJECTINFO2 содержит структуру CPUNotification .

void D3DKMT_PTR( HANDLE unnamedParam1, Event unnamedParam2)

MonitoredFence

Структура, содержащая сведения о отслеживаемом заборе. Если элемент Type равен D3DDDI_MONITORED_FENCE, объединение в D3DDDI_SYNCHRONIZATIONOBJECTINFO2 содержит структуру MonitoredFence .

Отслеживаемые заборы можно совместно использовать только с помощью дескрипторов NT в целях безопасности, поэтому при использовании отслеживаемого забора необходимо установить флаг NtSecuritySharing .