DXGKDDI_UPDATEACTIVEVIDPNPRESENTPATH fungsi panggilan balik (d3dkmddi.h)

Fungsi DxgkDdiUpdateActiveVidPnPresentPath memperbarui salah satu jalur 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 dalam 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.

Mengembalikan nilai

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 video yang ada, seperti rotasi jalur, transformasi geometri konten yang disajikan, landai gamma yang digunakan untuk menyesuaikan kecerahan konten yang disajikan, dan sebagainya.

Catatan Fungsi DxgkDdiUpdateActiveVidPnPresentPath driver miniport tampilan harus mendukung gamma ramps.
 
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.

Persyaratan

   
Klien minimum yang didukung Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows.
Target Platform Desktop
Header d3dkmddi.h
IRQL PASSIVE_LEVEL

Lihat juga

D3DKMDT_VIDPN_PRESENT_PATH

DXGKARG_UPDATEACTIVEVIDPNPRESENTPATH

DXGK_DRIVERCAPS

DxgkDdiAddDevice

DxgkDdiCommitVidPn