DXGKDDI_VIDPNTOPOLOGY_ENUMPATHTARGETSFROMSOURCE fungsi panggilan balik (d3dkmddi.h)

  • Artikel

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

Lihat juga

pfnGetNumPathsFromSource

pfnGetPathSourceFromTarget