DXGKDDI_VIDPNTARGETMODESET_ACQUIRENEXTMODEINFO fungsi panggilan balik (d3dkmddi.h)

Artikel
02/23/2024

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

Sintaks

DXGKDDI_VIDPNTARGETMODESET_ACQUIRENEXTMODEINFO DxgkddiVidpntargetmodesetAcquirenextmodeinfo;

NTSTATUS DxgkddiVidpntargetmodesetAcquirenextmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [in]  IN_CONST_PD3DKMDT_VIDPN_TARGET_MODE_CONST pVidPnTargetModeInfo,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_TARGET_MODE ppNextVidPnTargetModeInfo
)
{...}

Parameter

[in] hVidPnTargetModeSet

Handel ke objek set mode target VidPN. Driver miniport tampilan sebelumnya mendapatkan handel ini dengan memanggil fungsi pfnAcquireTargetModeSet dari antarmuka DXGK_VIDPN_INTERFACE .

[in] pVidPnTargetModeInfo

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

[out] ppNextVidPnTargetModeInfo

Penunjuk ke variabel yang menerima penunjuk ke struktur D3DKMDT_VIDPN_TARGET_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_TARGETMODESET	Handel yang disediakan dalam hVidPnTargetModeSet tidak valid.

Keterangan

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

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

Jenis data D3DKMDT_HVIDPNTARGETMODESET ditentukan dalam D3dkmdt.h.