DXGKDDI_RECOMMENDFUNCTIONALVIDPN fungsi panggilan balik (d3dkmddi.h)

Artikel
05/26/2023

Fungsi DxgkDdiRecommendFunctionalVidPn membuat VidPN fungsional yang dapat diimplementasikan pada adaptor tampilan tertentu.

Sintaks

DXGKDDI_RECOMMENDFUNCTIONALVIDPN DxgkddiRecommendfunctionalvidpn;

NTSTATUS DxgkddiRecommendfunctionalvidpn(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_RECOMMENDFUNCTIONALVIDPN_CONST pRecommendFunctionalVidPn
)
{...}

Parameter

[in] hAdapter

Handel ke blok konteks yang terkait dengan adaptor tampilan. Driver miniport tampilan sebelumnya menyediakan handel ini ke subsistem kernel grafis DirectX dalam parameter output MiniportDeviceContext dari fungsi DxgkDdiAddDevice .

[in] pRecommendFunctionalVidPn

Penunjuk ke struktur DXGKARG_RECOMMENDFUNCTIONALVIDPN yang berisi argumen fungsi. Pemanggil memasok anggota hRecommendedFunctionalVidPn , yang merupakan handel ke objek VidPN kosong. DxgkDdiRecommendFunctionalVidPn mengisi objek VidPN dengan elemen VidPN fungsional: topologi, set mode, mode yang disematkan.

Menampilkan nilai

DxgkDdiRecommendFunctionalVidPn mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Fungsi ini berhasil membuat VidPN fungsi.
STATUS_GRAPHICS_NO_RECOMMENDED_FUNCTIONAL_VIDPN	Fungsi ini tidak dapat membuat VidPN fungsi.
STATUS_NO_MEMORY	Fungsi gagal karena tidak dapat mengalokasikan memori.

Keterangan

VidPN berfungsi jika memenuhi kondisi berikut:

Ini memiliki topologi yang memiliki setidaknya satu jalur. (Jalur adalah hubungan antara sumber dan target.)
Setiap sumber dan target dalam topologi memiliki mode yang disematkan.

Pekerjaan DxgkDdiRecommendFunctionalVidPn adalah membuat VidPN fungsional yang dapat diimplementasikan pada adaptor tampilan. Daftar berikut memberikan langkah-langkah yang digunakan untuk membuat VidPN fungsi.

Mulailah dengan handel ke objek VidPN kosong. Handel ini disediakan pada anggota hDesiredVidPn dari pRecommendFunctionalVidPnArg.
Tambahkan jalur (pasangan target sumber) ke topologi VidPN.
Buat set mode sumber baru dan tambahkan satu mode sumber ke set. Tetapkan mode sumber yang diatur ke sumber di jalur Anda. Sematkan mode sumber.
Buat set mode target baru dan tambahkan satu mode target ke set. Tetapkan mode target yang diatur ke target di jalur Anda. Sematkan mode target.

Untuk informasi tentang cara menambahkan jalur, menambahkan set mode, menetapkan mode, dan menyematkan mode, lihat Objek dan Antarmuka VidPN.

DxgkDdiRecommendFunctionalVidPn harus dibuat dapat dipaginasi.

Persyaratan

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

Bagikan melalui