struktur DISPLAYCONFIG_PATH_TARGET_INFO (wingdi.h)

Artikel
03/04/2024

Struktur DISPLAYCONFIG_PATH_TARGET_INFO berisi informasi target untuk satu jalur.

Sintaks

typedef struct DISPLAYCONFIG_PATH_TARGET_INFO {
  LUID                                  adapterId;
  UINT32                                id;
  union {
    UINT32 modeInfoIdx;
    struct {
      UINT32 desktopModeInfoIdx : 16;
      UINT32 targetModeInfoIdx : 16;
    } DUMMYSTRUCTNAME;
  } DUMMYUNIONNAME;
  DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY outputTechnology;
  DISPLAYCONFIG_ROTATION                rotation;
  DISPLAYCONFIG_SCALING                 scaling;
  DISPLAYCONFIG_RATIONAL                refreshRate;
  DISPLAYCONFIG_SCANLINE_ORDERING       scanLineOrdering;
  BOOL                                  targetAvailable;
  UINT32                                statusFlags;
} DISPLAYCONFIG_PATH_TARGET_INFO;

Anggota

adapterId

Pengidentifikasi adaptor tempat jalur berada.

id

Pengidentifikasi target pada adaptor yang ditentukan yang terkait dengan jalur ini.

DUMMYUNIONNAME

DUMMYUNIONNAME.modeInfoIdx

Indeks yang valid ke dalam tabel informasi mode yang berisi informasi mode target untuk jalur ini hanya ketika DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODE tidak diatur. Jika informasi mode target tidak tersedia, nilai modeInfoIdx DISPLAYCONFIG_PATH_MODE_IDX_INVALID.

DUMMYUNIONNAME.DUMMYSTRUCTNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME.desktopModeInfoIdx

Indeks yang valid ke dalam array mode entri DISPLAYCONFIG_DESKTOP_IMAGE_INFO yang berisi informasi mode desktop untuk jalur ini hanya ketika DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODE diatur. Jika tidak ada entri untuk ini dalam array mode, nilai desktopModeInfoIdx DISPLAYCONFIG_PATH_DESKTOP_IMAGE_IDX_INVALID. Didukung mulai dari Windows 10.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.targetModeInfoIdx

Indeks yang valid ke dalam array mode entri DISPLAYCONFIG_TARGET_MODE yang berisi informasi mode target untuk jalur ini hanya ketika DISPLAYCONFIG_PATH_SUPPORT_VIRTUAL_MODE diatur. Jika tidak ada entri untuk ini dalam array mode, nilai targetModeInfoIdx DISPLAYCONFIG_PATH_TARGET_MODE_IDX_INVALID. Didukung mulai dari Windows 10.

outputTechnology

Jenis konektor target. Untuk daftar nilai yang mungkin, lihat jenis enumerasi DISPLAYCONFIG_VIDEO_OUTPUT_TECHNOLOGY .

rotation

Nilai yang menentukan rotasi target. Untuk daftar nilai yang mungkin, lihat jenis enumerasi DISPLAYCONFIG_ROTATION .

scaling

Nilai yang menentukan bagaimana gambar sumber diskalakan ke target. Untuk daftar nilai yang mungkin, lihat jenis enumerasi DISPLAYCONFIG_SCALING . Untuk informasi selengkapnya tentang penskalaan, lihat Menskalakan Gambar Desktop.

refreshRate

Struktur DISPLAYCONFIG_RATIONAL yang menentukan laju refresh target. Jika pemanggil menentukan informasi mode target, sistem operasi akan menggunakan kecepatan refresh yang disimpan dalam anggota vSyncFreq dari struktur DISPLAYCONFIG_VIDEO_SIGNAL_INFO . Dalam hal ini, pemanggil menentukan nilai ini di anggota targetVideoSignalInfo dari struktur DISPLAYCONFIG_TARGET_MODE . Laju refresh dengan pembiru dan penyebut diatur ke nol menunjukkan bahwa pemanggil tidak menentukan laju refresh dan sistem operasi harus menggunakan laju refresh paling optimal yang tersedia. Untuk kasus ini, dalam panggilan ke fungsi SetDisplayConfig , pemanggil harus mengatur anggota scanLineOrdering ke nilai DISPLAYCONFIG_SCANLINE_ORDERING_UNSPECIFIED; jika tidak, SetDisplayConfig gagal.

scanLineOrdering

Nilai yang menentukan urutan baris pemindaian output pada target. Untuk daftar nilai yang mungkin, lihat jenis enumerasi DISPLAYCONFIG_SCANLINE_ORDERING . Jika pemanggil menentukan informasi mode target, sistem operasi akan menggunakan urutan baris pemindaian yang disimpan dalam anggota scanLineOrdering dari struktur DISPLAYCONFIG_VIDEO_SIGNAL_INFO . Dalam hal ini, pemanggil menentukan nilai ini di anggota targetVideoSignalInfo dari struktur DISPLAYCONFIG_TARGET_MODE .

targetAvailable

Nilai Boolean yang menentukan apakah target tersedia. TRUE menunjukkan bahwa target tersedia.

Karena sifat asinkron topologi tampilan berubah saat monitor dihapus, jalur mungkin masih ditandai sebagai aktif meskipun monitor telah dihapus. Dalam kasus seperti itu, targetAvailable bisa berupa FALSE untuk jalur aktif. Ini biasanya merupakan situasi sementara yang akan berubah setelah sistem operasi mengambil tindakan pada penghapusan monitor.

statusFlags

Bitwise ATAU nilai bendera yang menunjukkan status target. Nilai berikut ini didukung:

Nilai	Makna
DISPLAYCONFIG_TARGET_IN_USE 0x00000001	Target sedang digunakan pada jalur aktif.
DISPLAYCONFIG_TARGET_FORCIBLE 0x00000002	Output dapat dipaksa pada target ini meskipun monitor tidak terdeteksi.
DISPLAYCONFIG_TARGET_FORCED_AVAILABILITY_BOOT 0x00000004	Output saat ini dipaksa dengan cara yang persisten boot.
DISPLAYCONFIG_TARGET_FORCED_AVAILABILITY_PATH 0x00000008	Output saat ini sedang dipaksa dengan cara yang persisten jalur.
DISPLAYCONFIG_TARGET_FORCED_AVAILABILITY_SYSTEM 0x00000010	Output saat ini dipaksa dengan cara yang tidak konsisten.
DISPLAYCONFIG_TARGET_IS_HMD 0x00000020	Outputnya adalah layar yang dipasang di kepala (HMD). Jalur semacam itu hanya dikembalikan dari QueryDisplayConfig menggunakan bendera QDC_INCLUDE_HMD. Didukung mulai dari Windows 10 Creators Update (Versi 1703).

Keterangan

Struktur DISPLAYCONFIG_PATH_TARGET_INFO ditentukan dalam anggota targetInfo dari struktur DISPLAYCONFIG_PATH_INFO .

Target sesuai dengan jumlah kemungkinan output video pada adaptor tampilan. Namun, angka ini tidak sama dengan jumlah konektor fisik pada adaptor tampilan. Setiap konektor memaparkan sejumlah target yang mencakup kompatibilitas mundur dengan teknologi konektor yang lebih lama. Misalnya, konektor DVI mengekspos target DVI, serta target VGA. Konektor DisplayPort, yang diperkenalkan pada tahun 2006, mengekspos target DisplayPort, HDMI, DVI, TV warisan, dan VGA.

Anggota statusFlags diatur saat Anda memanggil fungsi QueryDisplayConfig .