DXGKDDI_VIDPNSOURCEMODESET_ACQUIREFIRSTMODEINFO fungsi panggilan balik (d3dkmddi.h)

Artikel
05/26/2023

Fungsi pfnAcquireFirstModeInfo mengembalikan deskriptor mode pertama dalam set mode sumber VidPN tertentu.

Sintaks

DXGKDDI_VIDPNSOURCEMODESET_ACQUIREFIRSTMODEINFO DxgkddiVidpnsourcemodesetAcquirefirstmodeinfo;

NTSTATUS DxgkddiVidpnsourcemodesetAcquirefirstmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_SOURCE_MODE ppFirstVidPnSourceModeInfo
)
{...}

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 .

[out] ppFirstVidPnSourceModeInfo

Penunjuk ke variabel yang menerima penunjuk ke struktur D3DKMDT_VIDPN_SOURCE_MODE . Struktur berisi berbagai informasi tentang mode , termasuk ID, jenis, dan format penyajiannya.

Menampilkan nilai

Fungsi pfnAcquireFirstModeInfo 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.