DXGKDDI_QUERY_CHILD_RELATIONS fungsi panggilan balik (dispmprt.h)

  • Artikel

Fungsi DxgkDdiQueryChildRelations menghitung perangkat anak dari adaptor tampilan.

Sintaks

DXGKDDI_QUERY_CHILD_RELATIONS DxgkddiQueryChildRelations;

NTSTATUS DxgkddiQueryChildRelations(
  [in]      IN_CONST_PVOID MiniportDeviceContext,
  [in, out] PDXGK_CHILD_DESCRIPTOR ChildRelations,
  [in]      ULONG ChildRelationsSize
)
{...}

Parameter

[in] MiniportDeviceContext

Handel ke blok konteks yang terkait dengan adaptor tampilan. Fungsi DxgkDdiAddDevice driver miniport tampilan sebelumnya menyediakan handel ini ke subsistem kernel grafis DirectX.

[in, out] ChildRelations

Penunjuk ke array struktur DXGK_CHILD_DESCRIPTOR yang dialokasikan dan di-nol oleh pemanggil. Jumlah elemen dalam array lebih besar dari nilai yang dikembalikan oleh DxgkDdiStartDevice dalam parameter NumberOfChildren . DxgkDdiQueryChildRelations harus mengisi semua kecuali struktur terakhir dalam array dengan informasi yang menjelaskan perangkat anak adaptor tampilan. Struktur terakhir dalam array harus tetap nol.

[in] ChildRelationsSize

Ukuran total, dalam byte, dari array ChildRelations termasuk struktur nol di akhir.

Nilai kembali

DxgkDdiQueryChildRelations mengembalikan STATUS_SUCCESS jika berhasil; jika tidak, ia mengembalikan salah satu kode kesalahan yang ditentukan dalam Ntstatus.h.

Keterangan

Semua perangkat anak dari adaptor tampilan onboard; monitor dan perangkat eksternal lainnya yang tersambung ke adaptor tampilan tidak dianggap sebagai perangkat anak.

Driver miniport tampilan harus mengisi array struktur DXGK_CHILD_DESCRIPTOR, satu untuk setiap anak adaptor tampilan. Array harus berisi struktur DXGK_CHILD_DESCRIPTOR untuk semua perangkat anak saat ini dan semua perangkat anak potensial. Misalnya, jika menambatkan komputer portabel akan mengakibatkan output video baru tersedia, output video tersebut harus memiliki deskriptor dalam array, bahkan jika saat ini tidak tersedia.

Fungsi DxgkDdiQueryChildRelations harus dibuat dapat dipaginasi.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows.
Target Platform Desktop
Header dispmprt.h
IRQL PASSIVE_LEVEL

Lihat juga

DXGK_CHILD_DESCRIPTOR

DXGK_CHILD_STATUS

DxgkDdiQueryChildStatus

DxgkDdiQueryDeviceDescriptor