DXGKDDI_VIDPN_GETTOPOLOGY fungsi panggilan balik (d3dkmddi.h)

  • Artikel

Fungsi pfnGetTopology mengembalikan handel ke objek topologi VidPN yang dimuat oleh objek VidPN tertentu.

Sintaks

DXGKDDI_VIDPN_GETTOPOLOGY DxgkddiVidpnGettopology;

NTSTATUS DxgkddiVidpnGettopology(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [out] OUT_PD3DKMDT_HVIDPNTOPOLOGY phVidPnTopology,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPNTOPOLOGY_INTERFACE ppVidPnTopologyInterface
)
{...}

Parameter

[in] hVidPn

Handel ke objek VidPN. Manajer VidPN sebelumnya memberikan handel ini ke driver miniport tampilan dengan memanggil DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn, atau DxgkDdiRecommendFunctionalVidPn.

[out] phVidPnTopology

Penunjuk ke variabel yang menerima handel ke objek topologi VidPN.

[out] ppVidPnTopologyInterface

Penunjuk ke variabel yang menerima penunjuk ke struktur DXGK_VIDPNTOPOLOGY_INTERFACE . Struktur berisi pointer ke fungsi yang dapat dipanggil driver miniport tampilan untuk memeriksa dan mengubah objek topologi VidPN.

Menampilkan nilai

Fungsi pfnGetTopology mengembalikan salah satu nilai berikut:

Menampilkan kode Deskripsi
STATUS_SUCCESS Fungsi berhasil.
STATUS_GRAPHICS_INVALID_VIDPN Handel yang disediakan dalam hVidPn tidak valid.

Keterangan

Driver miniport tampilan tidak perlu melepaskan handel yang diterimanya dalam phVidPnTopology.

Masa pakai struktur DXGK_VIDPNTOPOLOGY_INTERFACE yang dikembalikan dalam ppVidPnTopologyInterface dimiliki oleh sistem operasi. Dengan menggunakan skema kepemilikan ini, sistem operasi dapat bermigrasi ke implementasi yang lebih baru pada durasi tanpa merusak klien antarmuka.

Persyaratan

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

Lihat juga

DXGK_VIDPNTOPOLOGY_INTERFACE

Antarmuka Topologi VidPN