DXGKDDI_UPDATEACTIVEVIDPNPRESENTPATH fungsi panggilan balik (d3dkmddi.h)

Artikel
02/23/2024

Fungsi DxgkDdiUpdateActiveVidPnPresentPath memperbarui salah satu jalur sajian video yang saat ini aktif pada adaptor tampilan.

Sintaks

DXGKDDI_UPDATEACTIVEVIDPNPRESENTPATH DxgkddiUpdateactivevidpnpresentpath;

NTSTATUS DxgkddiUpdateactivevidpnpresentpath(
       IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_UPDATEACTIVEVIDPNPRESENTPATH_CONST pUpdateActiveVidPnPresentPath
)
{...}

Parameter

hAdapter

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

[in] pUpdateActiveVidPnPresentPath

Penunjuk ke struktur DXGKARG_UPDATEACTIVEVIDPNPRESENTPATH , yang berisi satu anggota: struktur D3DKMDT_VIDPN_PRESENT_PATH . Anggota struktur D3DKMDT_VIDPN_PRESENT_PATH mengidentifikasi jalur dan menyediakan pengaturan baru untuk jalur tersebut. Fungsi DxgkDdiUpdateActiveVidPnPresentPath harus memprogram jalur pada adaptor tampilan sesuai dengan pengaturan baru.

Nilai kembali

DxgkDdiUpdateActiveVidPnPresentPathmengembalikan salah satu nilai berikut:

Nilai	Deskripsi
STATUS_SUCCESS	Fungsi berhasil.
STATUS_GRAPHICS_PATH_NOT_IN_TOPOLOGY	Jalur yang ditentukan oleh pUpdateActiveVidPnPresentPathArg-VidPnPresentPathInfo> tidak berada dalam topologi VidPN aktif.
STATUS_GRAPHICS_PATH_CONTENT_GEOMETRY_TRANSFORMATION_NOT_SUPPORTED	Jalur tidak mendukung transformasi konten yang ditentukan oleh pUpdateActiveVidPnPresentPathArg-VidPnPresentPathInfo.ContentTransformation>. Jalur tidak mendukung ramp gamma yang ditentukan oleh pUpdateActiveVidPnPresentPathArg-VidPnPresentPathInfo.GammaRamp>.

Keterangan

Sistem operasi memanggil fungsi DxgkDdiUpdateActiveVidPnPresentPath untuk mengontrol pengaturan jalur sajian video, seperti rotasi jalur, transformasi geometri konten yang disajikan, landaian gamma yang digunakan untuk menyesuaikan kecerahan konten yang disajikan, dan sebagainya.

Catatan Fungsi DxgkDdiUpdateActiveVidPnPresentPath driver miniport tampilan harus mendukung landaian gamma.

Dimulai dengan Windows 8, jika driver miniport tampilan mengatur anggota SupportSmoothRotation dari struktur DXGK_DRIVERCAPS, itu harus mendukung pembaruan rotasi jalur pada adaptor menggunakan fungsi DxgkDdiUpdateActiveVidPnPresentPath. Driver harus selalu dapat mengatur rotasi jalur selama panggilan ke fungsi DxgkDdiCommitVidPn .

Fungsi DxgkDdiUpdateActiveVidPnPresentPath harus dibuat dapat dipaginasi.