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

Статья
10/23/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 {
      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;

Члены

Type

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

Flags

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

SynchronizationMutex

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

SynchronizationMutex.InitialState

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

Semaphore

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

Semaphore.MaxCount

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

Semaphore.InitialCount

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

Fence

Структура, содержащая сведения о заборе. Если член типа равен D3DDDI_FENCE, объединение в D3DDDI_SYNCHRONIZATIONOBJECTINFO2 содержит структуру ограждения.

Fence.FenceValue

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

CPUNotification

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

CPUNotification.Event

Дескриптор события уведомления ЦП.

MonitoredFence

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

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