DXGKDDI_MONITOR_GETADDITIONALMONITORMODESET fungsi panggilan balik (d3dkmddi.h)

Artikel
02/23/2024

Fungsi pfnGetAdditionalMonitorModeSet mengembalikan handel ke objek set mode sumber monitor tambahan yang terkait dengan monitor tertentu. Ini tersedia di antarmuka DXGK_MONITOR_INTERFACE_V2 , mulai dari Windows 7.

Sintaks

DXGKDDI_MONITOR_GETADDITIONALMONITORMODESET DxgkddiMonitorGetadditionalmonitormodeset;

NTSTATUS DxgkddiMonitorGetadditionalmonitormodeset(
  [in]  IN_CONST_D3DKMDT_ADAPTER hAdapter,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
  [out] OUT_PUINT pNumberModes,
  [out] DEREF_ECOUNT_PPDXGK_TARGETMODE_DETAIL_TIMING ppAdditionalModesSet
)
{...}

Parameter

[in] hAdapter

Handel yang mengidentifikasi adaptor tampilan. Subsistem kernel grafis Microsoft DirectX sebelumnya menyediakan handel ini ke driver miniport tampilan dalam parameter DxgkInterface dari fungsi DxgkDdiStartDevice .

[in] VideoPresentTargetId

Bilangan bulat yang mengidentifikasi salah satu video yang menyajikan target pada adaptor tampilan. Objek set mode tambahan ppAdditionalModesSet yang dikembalikan menjelaskan set mode sumber monitor tambahan yang tersedia di monitor yang tersambung ke target video ini.

[out] pNumberModes

Penunjuk ke variabel yang berisi jumlah mode pengaturan waktu tambahan dari target video yang ada yang ditentukan oleh VideoPresentTargetId.

[out] ppAdditionalModesSet

Penunjuk ke variabel yang menerima penunjuk ke struktur DXGK_TARGETMODE_DETAIL_TIMING . Struktur menjelaskan video yang menyajikan mode pengaturan waktu tambahan target yang kompatibel dengan perangkat tampilan.

Menampilkan nilai

Fungsi pfnAcquireMonitorSourceModeSet mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Fungsi berhasil.
STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER	Handel yang disediakan dalam hAdapter tidak valid.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET	Pengidentifikasi yang disediakan dalam VideoPresentTargetId tidak valid.
STATUS_GRAPHICS_MONITOR_NOT_CONNECTED	Tidak ada monitor yang terhubung ke target sajikan video yang diidentifikasi oleh VideoPresentTargetId.
STATUS_NOT_FOUND	Target video yang ada yang diidentifikasi oleh VideoPresentTargetId tidak dapat ditemukan.

Keterangan

Pengidentifikasi target VidPN ditetapkan oleh driver miniport tampilan. Fungsi DxgkDdiQueryChildRelations , yang diimplementasikan oleh driver miniport tampilan, mengembalikan array struktur DXGK_CHILD_DESCRIPTOR , yang masing-masing berisi pengidentifikasi.

Fungsi ini tersedia dimulai dengan Windows 7.