DXGKDDI_VIDPNTOPOLOGY_ACQUIREFIRSTPATHINFO fungsi panggilan balik (d3dkmddi.h)
Struktur pfnAcquireFirstPathInfo mengembalikan deskriptor jalur pertama dalam objek topologi VidPN tertentu.
Sintaks
DXGKDDI_VIDPNTOPOLOGY_ACQUIREFIRSTPATHINFO DxgkddiVidpntopologyAcquirefirstpathinfo;
NTSTATUS DxgkddiVidpntopologyAcquirefirstpathinfo(
[in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
[out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_PRESENT_PATH ppFirstVidPnPresentPathInfo
)
{...}
Parameter
[in] hVidPnTopology
Handel ke objek topologi VidPN. Driver miniport tampilan sebelumnya memperoleh handel ini dengan memanggil fungsi pfnGetTopology dari antarmuka DXGK_VIDPN_INTERFACE .
[out] ppFirstVidPnPresentPathInfo
Penunjuk ke variabel yang menerima penunjuk ke struktur D3DKMDT_VIDPN_PRESENT_PATH . Struktur berisi berbagai informasi tentang jalur, termasuk pengidentifikasi sumber dan target jalur.
Menampilkan nilai
Fungsi pfnAcquireFirstPathInfo mengembalikan salah satu nilai berikut:
| Menampilkan kode | Deskripsi |
|---|---|
| STATUS_SUCCESS | Fungsi berhasil. |
| STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY | Handel yang disediakan dalam hVidPnTopology tidak valid. |
Keterangan
Setelah selesai menggunakan struktur D3DKMDT_VIDPN_PRESENT_PATH, Anda harus merilis struktur dengan memanggil pfnReleasePathInfo.
Anda dapat menghitung semua jalur yang termasuk dalam objek topologi VidPN dengan memanggil pfnAcquireFirstPathInfo dan kemudian membuat urutan panggilan ke pfnAcquireNextPathInfo.
Jenis data D3DKMDT_HVIDPNTOPOLOGY ditentukan dalam D3dkmdt.h.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista |
| Target Platform | Desktop |
| Header | d3dkmddi.h (termasuk D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |