DXGKDDI_VIDPNTOPOLOGY_ADDPATH fungsi panggilan balik (d3dkmddi.h)

Artikel
03/30/2024

Fungsi pfnAddPath menambahkan jalur sajian video ke objek topologi VidPN tertentu.

Sintaks

DXGKDDI_VIDPNTOPOLOGY_ADDPATH DxgkddiVidpntopologyAddpath;

NTSTATUS DxgkddiVidpntopologyAddpath(
  [in] IN_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
  [in] IN_PD3DKMDT_VIDPN_PRESENT_PATH pVidPnPresentPath
)
{...}

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

Penunjuk ke struktur D3DKMDT_VIDPN_PRESENT_PATH yang menjelaskan jalur. Driver miniport tampilan sebelumnya mendapatkan pointer ini dengan memanggil pfnCreateNewPathInfo.

Mengembalikan nilai

Fungsi pfnAddPath mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Fungsi berhasil.
STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY	Handel yang disediakan dalam hVidPnTopology tidak valid.
STATUS_ACCESS_DENIED	Jalur tidak dapat dihapus dalam konteks panggilan DDI saat ini.

Keterangan

Untuk menambahkan jalur ke topologi, driver miniport tampilan melakukan langkah-langkah berikut.

Panggil pfnCreateNewPathInfo untuk mendapatkan penunjuk ke struktur D3DKMDT_VIDPN_PRESENT_PATH yang dialokasikan oleh manajer VidPN.

Isi struktur D3DKMDT_VIDPN_PRESENT_PATH dengan informasi tentang jalur, termasuk pengidentifikasi sumber dan target saji video.

Panggil pfnAddPath untuk menambahkan jalur ke topologi.

Manajer VidPN mengalokasikan struktur D3DKMDT_VIDPN_PRESENT_PATH saat Anda memanggil pfnCreateNewPathInfo. Jika Anda menambahkan jalur yang dijelaskan oleh struktur tersebut ke topologi, maka Anda tidak perlu melepaskan struktur secara eksplisit; pfnAddPath merilisnya.

Jika Anda mendapatkan struktur D3DKMDT_VIDPN_PRESENT_PATH dengan memanggil pfnCreateNewPathInfo dan kemudian memutuskan untuk tidak menambahkan jalur tersebut ke topologi, maka Anda harus secara eksplisit merilis struktur dengan memanggil pfnReleasePathInfo.

Jenis data D3DKMDT_HVIDPNTOPOLOGY ditentukan dalam D3dkmdt.h.