DXGKDDI_MONITORSOURCEMODESET_ACQUIRENEXTMODEINFO fungsi panggilan balik (d3dkmddi.h)

Artikel
05/26/2023

Fungsi pfnAcquireNextModeInfo mengembalikan deskriptor mode berikutnya dalam set mode sumber monitor tertentu, mengingat mode saat ini.

Sintaks

DXGKDDI_MONITORSOURCEMODESET_ACQUIRENEXTMODEINFO DxgkddiMonitorsourcemodesetAcquirenextmodeinfo;

NTSTATUS DxgkddiMonitorsourcemodesetAcquirenextmodeinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORSOURCEMODESET hMonitorSourceModeSet,
  [in]  IN_CONST_PD3DKMDT_MONITOR_SOURCE_MODE_CONST pMonitorSourceModeInfo,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_SOURCE_MODE ppNextMonitorSourceModeInfo
)
{...}

Parameter

[in] hMonitorSourceModeSet

Handel ke objek set mode sumber monitor. Driver miniport tampilan sebelumnya memperoleh handel ini dengan memanggil fungsi pfnAcquireMonitorSourceModeSet dari antarmuka Monitor.

[in] pMonitorSourceModeInfo

Penunjuk ke struktur D3DKMDT_MONITOR_SOURCE_MODE yang menjelaskan mode saat ini. Driver miniport tampilan sebelumnya memperoleh pointer ini dengan memanggil pfnAcquireFirstModeInfo atau pfnAcquireNextModeInfo.

[out] ppNextMonitorSourceModeInfo

Penunjuk ke variabel yang menerima penunjuk ke struktur D3DKMDT_MONITOR_SOURCE_MODE yang menjelaskan mode berikutnya.

Menampilkan nilai

Fungsi pfnAcquireNextModeInfo mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Fungsi berhasil.
STATUS_GRAPHICS_INVALID_MONITOR_SOURCEMODESET	Handel yang disediakan di hMonitorSourceModeSet tidak valid.

Keterangan

Setelah selesai menggunakan struktur D3DKMDT_MONITOR_SOURCE_MODE , Anda harus merilis struktur dengan memanggil pfnReleaseModeInfo.

Anda dapat menghitung semua mode yang termasuk dalam objek set mode sumber monitor tertentu dengan memanggil pfnAcquireFirstModeInfo dan kemudian melakukan urutan panggilan ke pfnAcquireNextModeInfo.

Jenis data D3DKMDT_HMONITORSOURCEMODESET ditentukan dalam D3dkmdt.h.