struktur D3DDDI_SYNCHRONIZATIONOBJECTINFO2 (d3dukmdt.h)

Artikel
06/08/2024

Struktur D3DDDI_SYNCHRONIZATIONOBJECTINFO2 berisi informasi tentang objek sinkronisasi generasi kedua.

Sintaks

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;

Anggota

Type

[in] Nilai jenis D3DDDI_SYNCHRONIZATIONOBJECT_TYPE yang menunjukkan jenis objek sinkronisasi.

Flags

[in] Struktur D3DDDI_SYNCHRONIZATIONOBJECT_FLAGS yang menentukan, dalam bendera bidang bit, atribut objek sinkronisasi.

SynchronizationMutex

Struktur yang berisi informasi tentang mutex sinkronisasi. Jika anggota Jenis sama dengan D3DDDI_SYNCHRONIZATION_MUTEX, penyatuan di D3DDDI_SYNCHRONIZATIONOBJECTINFO2 menyimpan struktur SynchronizationMutex .

SynchronizationMutex.InitialState

Nilai Boolean yang menunjukkan apakah mutex sinkronisasi awalnya dimiliki oleh objek. Nilai TRUE menunjukkan bahwa mutex dimiliki; FALSE menunjukkan bahwa mutex tidak dimiliki.

Semaphore

Struktur yang berisi informasi tentang semaphore. Jika anggota Jenis sama dengan D3DDDI_SEMAPHORE, serikat di D3DDDI_SYNCHRONIZATIONOBJECTINFO2 memegang struktur Semaphore .

Semaphore.MaxCount

Jumlah maksimum peristiwa yang dapat dinanti objek.

Semaphore.InitialCount

Jumlah awal peristiwa yang dinanti objek.

Fence

Struktur yang berisi informasi tentang pagar. Jika anggota Jenis sama dengan D3DDDI_FENCE, serikat di D3DDDI_SYNCHRONIZATIONOBJECTINFO2 memegang struktur Pagar .

Fence.FenceValue

Nilai 64-bit yang menentukan nilai pagar awal.

CPUNotification

Struktur yang berisi informasi tentang pemberitahuan CPU. Jika anggota Jenis sama dengan D3DDDI_CPU_NOTIFICATION, gabungan di D3DDDI_SYNCHRONIZATIONOBJECTINFO2 memegang struktur CPUNotification .

void D3DKMT_PTR( HANDLE unnamedParam1, Event unnamedParam2)

MonitoredFence

Struktur yang berisi informasi tentang pagar yang dipantau. Jika anggota Jenis sama dengan D3DDDI_MONITORED_FENCE, union di D3DDDI_SYNCHRONIZATIONOBJECTINFO2 memegang struktur MonitoredFence .

Pagar yang dipantau hanya dapat dibagikan dengan menggunakan handel NT karena alasan keamanan, sehingga bendera NtSecuritySharing harus diatur saat menggunakan pagar yang dipantau.