DXGKDDI_VIDPNTOPOLOGY_ENUMPATHTARGETSFROMSOURCE fungsi panggilan balik (d3dkmddi.h)
Fungsi pfnEnumPathTargetsFromSource mengembalikan pengidentifikasi salah satu target video yang ada yang terkait dengan sumber sajian video tertentu.
Sintaks
DXGKDDI_VIDPNTOPOLOGY_ENUMPATHTARGETSFROMSOURCE DxgkddiVidpntopologyEnumpathtargetsfromsource;
NTSTATUS DxgkddiVidpntopologyEnumpathtargetsfromsource(
[in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
[in] IN_CONST_D3DKMDT_VIDPN_PRESENT_PATH_INDEX VidPnPresentPathIndex,
[out] OUT_PD3DDDI_VIDEO_PRESENT_TARGET_ID pVidPnTargetId
)
{...}
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 tertentu yang ada.
[in] VidPnPresentPathIndex
Indeks berbasis nol ke dalam set jalur yang berisi sumber yang diidentifikasi oleh VidPnSourceId.
[out] pVidPnTargetId
Penunjuk ke variabel yang menerima pengidentifikasi target.
Menampilkan nilai
Fungsi pfnEnumPathTargetsFromSource mengembalikan salah satu nilai berikut:
Menampilkan kode | Deskripsi |
---|---|
STATUS_SUCCESS | Fungsi berhasil. |
STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY | Handel yang disediakan dalam hVidPnTopology tidak valid. |
STATUS_INVALID_PARAMETER | Pointer yang disediakan dalam pVidPnTargetId valid. |
Keterangan
VidPnPresentPathIndex bukan indeks ke dalam kumpulan semua jalur dalam topologi yang diidentifikasi oleh hVidPnTopology. Ini adalah indeks ke dalam subset dari semua jalur dalam topologi: khususnya, subset dari semua jalur yang berisi sumber yang diidentifikasi oleh VidPnSourceId.
Untuk menghitung (dalam topologi tertentu) semua target yang terkait dengan sumber tertentu, lakukan langkah-langkah berikut.
Panggil pfnGetNumPathsFromSource untuk menentukan jumlah N jalur yang berisi sumber yang diminati. Anggap jalur tersebut sebagai set terindeks dengan indeks 0, 1, ... N - 1.
Untuk setiap indeks 0 meskipun N - 1, teruskan pengidentifikasi sumber dan indeks ke pfnEnumPathTargetsFromSource.
Topologi adalah jalur koleksi, yang masing-masing berisi pasangan (sumber, target). Dimungkinkan bagi sumber tertentu untuk muncul di lebih dari satu jalur. Misalnya, satu sumber dapat dipasangkan dengan dua target yang berbeda dalam kasus tampilan kloning.
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 dan D3DKMDT_VIDPN_PRESENT_PATH_INDEX 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 |