DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIRENEXTFREQUENCYRANGEINFO fungsi panggilan balik (d3dkmddi.h)

Artikel
03/08/2023

Fungsi pfnAcquireNextFrequencyRangeInfo mengembalikan deskriptor rentang frekuensi berikutnya dalam kumpulan rentang frekuensi monitor, mengingat deskriptor rentang frekuensi saat ini.

Sintaks

DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIRENEXTFREQUENCYRANGEINFO DxgkddiMonitorfrequencyrangesetAcquirenextfrequencyrangeinfo;

NTSTATUS DxgkddiMonitorfrequencyrangesetAcquirenextfrequencyrangeinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORFREQUENCYRANGESET hMonitorFrequencyRangeSet,
  [in]  IN_CONST_PD3DKMDT_MONITOR_FREQUENCY_RANGE_CONST pMonitorFrequencyRangeInfo,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_FREQUENCY_RANGE ppNextMonitorFrequencyRangeInfo
)
{...}

Parameter

[in] hMonitorFrequencyRangeSet

Handel ke objek set rentang frekuensi monitor. Driver miniport tampilan sebelumnya memperoleh handel ini dengan memanggil fungsi pfnGetMonitorFrequencyRangeSet dari Antarmuka Monitor.

[in] pMonitorFrequencyRangeInfo

Penunjuk ke struktur D3DKMDT_MONITOR_FREQUENCY_RANGE yang merupakan deskriptor rentang frekuensi saat ini. Driver miniport tampilan sebelumnya memperoleh pointer ini dengan memanggil pfnAcquireFirstFrequencyRangeInfo atau pfnAcquireNextFrequencyRangeInfo.

[out] ppNextMonitorFrequencyRangeInfo

Penunjuk ke variabel yang menerima penunjuk ke struktur D3DKMDT_MONITOR_FREQUENCY_RANGE yang merupakan deskriptor rentang frekuensi berikutnya.

Menampilkan nilai

Fungsi pfnAcquireNextFrequencyRangeInfo mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Fungsi berhasil mengembalikan deskriptor rentang frekuensi berikutnya.
STATUS_GRAPHICS_DATASET_IS_EMPTY	Fungsi berhasil, tetapi tidak ada lagi deskriptor rentang frekuensi dalam set.
STATUS_INVALID_PARAMETER	Parameter yang tidak valid disediakan.
STATUS_INVALID_FREQUENCYRANGE	Deskriptor rentang frekuensi yang disediakan dalam pMonitorFrequencyRangeInfo tidak valid.
STATUS_INVALID_MONITOR_FREQUENCYRANGESET	Handel yang disediakan di hMonitorFrequencyRangeSet tidak valid.

Fungsi ini mungkin juga mengembalikan kode kesalahan lain yang ditentukan dalam Ntstatus.h.

Keterangan

Setelah selesai menggunakan struktur D3DKMDT_MONITOR_FREQUENCY_RANGE, Anda harus merilis struktur dengan memanggil pfnReleaseFrequencyRangeInfo.

Anda dapat memperoleh semua deskriptor dalam rentang frekuensi monitor yang ditetapkan dengan memanggil pfnAcquireFirstFrequencyRangeInfo dan kemudian membuat urutan panggilan ke pfnAcquireNextFrequencyRangeInfo.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Target Platform	Desktop
Header	d3dkmddi.h (termasuk D3dkmddi.h)
IRQL	PASSIVE_LEVEL

Bagikan melalui