DXGKDDI_VIDPNTOPOLOGY_ACQUIREPATHINFO fungsi panggilan balik (d3dkmddi.h)

Artikel
02/23/2024

Fungsi pfnAcquirePathInfo mengembalikan deskriptor jalur sajian video yang ditentukan oleh sumber video yang ada dan target sajikan video dalam topologi VidPN tertentu.

Sintaks

DXGKDDI_VIDPNTOPOLOGY_ACQUIREPATHINFO DxgkddiVidpntopologyAcquirepathinfo;

NTSTATUS DxgkddiVidpntopologyAcquirepathinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
  [out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_PRESENT_PATH ppVidPnPresentPathInfo
)
{...}

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] VidPnSourceId

Bilangan bulat yang mengidentifikasi sumber video yang ada.

[in] VidPnTargetId

Bilangan bulat yang mengidentifikasi target video yang ada.

[out] ppVidPnPresentPathInfo

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

Menampilkan nilai

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

Jalur berisi pasangan (sumber, target), dan topologi adalah kumpulan jalur. Fungsi ini mengembalikan deskriptor untuk jalur, dalam topologi tertentu, yang berisi pasangan (sumber, target) tertentu.

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

Pengidentifikasi sumber VidPN ditetapkan oleh sistem operasi. DxgkDdiStartDevice, yang diimplementasikan oleh driver miniport tampilan, mengembalikan angka N sumber sajian video yang didukung oleh adaptor tampilan. Kemudian sistem operasi menetapkan pengidentifikasi 0, 1, 2, ... N - 1.

Pengidentifikasi target VidPN ditetapkan oleh driver miniport tampilan. DxgkDdiQueryChildRelations, yang diimplementasikan oleh driver miniport tampilan, mengembalikan array struktur DXGK_CHILD_DESCRIPTOR , yang masing-masing berisi pengidentifikasi.

Jenis data D3DKMDT_HVIDPNTOPOLOGY ditentukan dalam D3dkmdt.h.

Jenis data D3DDDI_VIDEO_PRESENT_SOURCE_ID dan D3DDDI_VIDEO_PRESENT_TARGET_ID ditentukan dalam D3dukmdt.h.