DXGKDDI_VIDPNSOURCEMODESET_ACQUIRENEXTMODEINFO fungsi panggilan balik (d3dkmddi.h)

Artikel
05/26/2023

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

Sintaks

DXGKDDI_VIDPNSOURCEMODESET_ACQUIRENEXTMODEINFO DxgkddiVidpnsourcemodesetAcquirenextmodeinfo;

NTSTATUS DxgkddiVidpnsourcemodesetAcquirenextmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [in]  IN_CONST_PD3DKMDT_VIDPN_SOURCE_MODE_CONST pVidPnSourceModeInfo,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_SOURCE_MODE ppNextVidPnSourceModeInfo
)
{...}

Parameter

[in] hVidPnSourceModeSet

Handel ke objek set mode sumber VidPN. Driver miniport tampilan sebelumnya memperoleh handel ini dengan memanggil fungsi pfnAcquireSourceModeSet dari antarmuka DXGK_VIDPN_INTERFACE .

[in] pVidPnSourceModeInfo

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

[out] ppNextVidPnSourceModeInfo

Penunjuk ke variabel yang menerima penunjuk ke struktur D3DKMDT_VIDPN_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_VIDPN_SOURCEMODESET	Handel yang disediakan dalam hVidPnSourceModeSet tidak valid.

Keterangan

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

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

Jenis data D3DKMDT_HVIDPNSOURCEMODESET ditentukan dalam D3dkmdt.h.