DXGKDDI_VIDPNTOPOLOGY_ACQUIREFIRSTPATHINFO fungsi panggilan balik (d3dkmddi.h)

  • Artikel

Struktur pfnAcquireFirstPathInfo mengembalikan deskriptor jalur pertama dalam objek topologi VidPN tertentu.

Sintaks

DXGKDDI_VIDPNTOPOLOGY_ACQUIREFIRSTPATHINFO DxgkddiVidpntopologyAcquirefirstpathinfo;

NTSTATUS DxgkddiVidpntopologyAcquirefirstpathinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_PRESENT_PATH ppFirstVidPnPresentPathInfo
)
{...}

Parameter

[in] hVidPnTopology

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

[out] ppFirstVidPnPresentPathInfo

Penunjuk ke variabel yang menerima penunjuk ke struktur D3DKMDT_VIDPN_PRESENT_PATH . Struktur berisi berbagai informasi tentang jalur, termasuk pengidentifikasi sumber dan target jalur.

Menampilkan nilai

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

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista
Target Platform Desktop
Header d3dkmddi.h (termasuk D3dkmddi.h)
IRQL PASSIVE_LEVEL

Lihat juga

D3DKMDT_VIDPN_PRESENT_PATH

pfnAcqirePathInfo

pfnAcquireNextPathInfo

pfnReleasePathInfo