DXGKDDI_VIDPNTOPOLOGY_ACQUIREPATHINFO fungsi panggilan balik (d3dkmddi.h)
Fungsi pfnAcquirePathInfo mengembalikan deskriptor jalur sajian video yang ditentukan oleh sumber video yang ada dan target sajikan video dalam topologi VidPN tertentu.
Sintaks
DXGKDDI_VIDPNTOPOLOGY_ACQUIREPATHINFO DxgkddiVidpntopologyAcquirepathinfo;
NTSTATUS DxgkddiVidpntopologyAcquirepathinfo(
[in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
[out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_PRESENT_PATH ppVidPnPresentPathInfo
)
{...}
Parameter
[in] hVidPnTopology
Handel ke objek topologi VidPN. Driver miniport tampilan sebelumnya memperoleh handel ini dengan memanggil fungsi pfnGetTopology dari antarmuka DXGK_VIDPN_INTERFACE .
[in] VidPnSourceId
Bilangan bulat yang mengidentifikasi sumber video yang ada.
[in] VidPnTargetId
Bilangan bulat yang mengidentifikasi target video yang ada.
[out] ppVidPnPresentPathInfo
Penunjuk ke variabel yang menerima penunjuk ke struktur D3DKMDT_VIDPN_PRESENT_PATH yang menjelaskan jalur yang diminta.
Menampilkan nilai
Fungsi pfnAcquirePathInfo 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.
Jalur berisi pasangan (sumber, target), dan topologi adalah kumpulan jalur. Fungsi ini mengembalikan deskriptor untuk jalur, dalam topologi tertentu, yang berisi pasangan (sumber, target) tertentu.
Anda dapat menghitung semua jalur yang termasuk dalam objek topologi VidPN dengan memanggil pfnAcquireFirstPathInfo dan kemudian membuat urutan panggilan ke pfnAcquireNextPathInfo.
Pengidentifikasi sumber VidPN ditetapkan oleh sistem operasi. DxgkDdiStartDevice, yang diimplementasikan oleh driver miniport tampilan, mengembalikan angka N sumber sajian video yang didukung oleh adaptor tampilan. Kemudian sistem operasi menetapkan pengidentifikasi 0, 1, 2, ... N - 1.
Pengidentifikasi target VidPN ditetapkan oleh driver miniport tampilan. DxgkDdiQueryChildRelations, yang diimplementasikan oleh driver miniport tampilan, mengembalikan array struktur DXGK_CHILD_DESCRIPTOR , yang masing-masing berisi pengidentifikasi.
Jenis data D3DKMDT_HVIDPNTOPOLOGY ditentukan dalam D3dkmdt.h.
Jenis data D3DDDI_VIDEO_PRESENT_SOURCE_ID dan D3DDDI_VIDEO_PRESENT_TARGET_ID ditentukan dalam D3dukmdt.h.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Vista |
Target Platform | Desktop |
Header | d3dkmddi.h (termasuk D3dkmddi.h) |
IRQL | PASSIVE_LEVEL |