DXGKDDI_VIDPNTOPOLOGY_ACQUIRENEXTPATHINFO fungsi panggilan balik (d3dkmddi.h)

Artikel
05/26/2023

Fungsi pfnAcquireNextPathInfo mengembalikan deskriptor jalur sajian video berikutnya dalam topologi VidPN tertentu, mengingat jalur saat ini.

Sintaks

DXGKDDI_VIDPNTOPOLOGY_ACQUIRENEXTPATHINFO DxgkddiVidpntopologyAcquirenextpathinfo;

NTSTATUS DxgkddiVidpntopologyAcquirenextpathinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [in]  IN_CONST_PD3DKMDT_VIDPN_PRESENT_PATH_CONST pVidPnPresentPathInfo,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_PRESENT_PATH ppNextVidPnPresentPathInfo
)
{...}

Parameter

[in] hVidPnTopology

Handel ke objek topologi VidPN. Driver miniport tampilan sebelumnya memperoleh handel ini dengan memanggil fungsi pfnGetTopology dari antarmuka DXGK_VIDPN_INTERFACE .

[in] pVidPnPresentPathInfo

Penunjuk ke struktur D3DKMDT_VIDPN_PRESENT_PATH yang menjelaskan jalur saat ini. Driver miniport tampilan sebelumnya mendapatkan pointer ini dengan memanggil pfnAcquireFirstPathInfo atau pfnAcquireNextPathInfo.

[out] ppNextVidPnPresentPathInfo

Penunjuk ke variabel yang menerima penunjuk ke struktur D3DKMDT_VIDPN_PRESENT_PATH yang menjelaskan jalur berikutnya.

Menampilkan nilai

Fungsi pfnAcquireNextPathInfo mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Fungsi berhasil.
STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY	Handel yang disediakan dalam hVidPnTopology tidak valid.

Keterangan

Setelah selesai menggunakan struktur D3DKMDT_VIDPN_PRESENT_PATH, Anda harus merilis struktur dengan memanggil pfnReleasePathInfo.

Anda dapat menghitung semua jalur yang termasuk dalam objek topologi VidPN dengan memanggil pfnAcquireFirstPathInfo dan kemudian membuat urutan panggilan ke pfnAcquireNextPathInfo.

Jenis data D3DKMDT_HVIDPNTOPOLOGY ditentukan dalam D3dkmdt.h.