DXGKDDI_VIDPN_GETTOPOLOGY fungsi panggilan balik (d3dkmddi.h)
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 |