DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIRENEXTFREQUENCYRANGEINFO fungsi panggilan balik (d3dkmddi.h)

  • Artikel

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