DXGKDDI_GET_CHILD_CONTAINER_ID fungsi panggilan balik (dispmprt.h)
Mengkueri ID kontainer untuk target yang ditentukan. Diimplementasikan oleh Windows Display Driver Model (WDDM) 1.2 dan yang lebih baru menampilkan driver miniport.
Sintaks
DXGKDDI_GET_CHILD_CONTAINER_ID DxgkddiGetChildContainerId;
NTSTATUS DxgkddiGetChildContainerId(
[in] PVOID MiniportDeviceContext,
[in] ULONG ChildUid,
[in, out] PDXGK_CHILD_CONTAINER_ID ContainerId
)
{...}
Parameter
[in] MiniportDeviceContext
Handel ke blok konteks yang terkait dengan adaptor tampilan. Fungsi DxgkDdiAddDevice driver miniport tampilan sebelumnya memberikan handel ini ke subsistem kernel grafis Microsoft DirectX.
[in] ChildUid
Nilai ULONG yang secara unik mengidentifikasi perangkat anak. Driver miniport tampilan sebelumnya menyediakan pengidentifikasi ini ketika fungsi DxgkDdiQueryChildRelations dipanggil.
[in, out] ContainerId
Penunjuk ke struktur DXGK_CHILD_CONTAINER_ID . Untuk informasi lebih lanjut, lihat bagian Keterangan.
Nilai kembali
Mengembalikan salah satu kode kesalahan berikut.
| Menampilkan kode | Deskripsi |
|---|---|
| STATUS_SUCCESS | Driver telah memperbarui struktur yang ditujukan oleh parameter ContainerId dengan informasi ID kontainer yang diperoleh dari perangkat keras tampilan. |
| STATUS_MONITOR_NODESCRIPTOR | Driver telah menerima informasi ID kontainer default yang disediakan dalam struktur yang ditujukkan oleh ContainerId. Catatan: Jika driver mengembalikan kode status ini, itu tidak boleh mengubah struktur. |
Jika tidak, fungsi mengembalikan salah satu kode status yang ditentukan dalam Ntstatus.h.
Keterangan
Sistem operasi memanggil fungsi DxgkDdiQueryChildRelations driver miniport tampilan untuk menghitung perangkat anak adaptor tampilan. Sistem operasi kemudian memanggil fungsi DxgkDdiQueryDeviceDescriptor driver miniport tampilan untuk setiap perangkat anak untuk mendapatkan Extended Display Information Data (EDID) untuk perangkat. Untuk informasi selengkapnya tentang prosedur ini, lihat Menghitung Perangkat Anak dari Adaptor Tampilan.
Berdasarkan data EDID perangkat, sistem operasi menghasilkan ID kontainer default untuk perangkat anak. Kemudian, sistem operasi memanggil fungsi DxgkDdiGetChildContainerId driver miniport tampilan dan meneruskan pointer ke struktur DXGK_CHILD_CONTAINER_ID melalui parameter ContainerId . Anggota ContainerId dari struktur ini berisi ID kontainer default untuk perangkat tampilan anak.
Driver miniport tampilan dapat menerima ID kontainer default atau mengatur anggota ContainerId ke pengidentifikasi unik untuk perangkat sebelum kembali dari panggilan ke DxgkDdiGetChildContainerId.
Untuk informasi selengkapnya tentang ID Kontainer, lihat ID Kontainer.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 8 |
| Server minimum yang didukung | Windows Server 2012 |
| Target Platform | Desktop |
| Header | dispmprt.h |
| IRQL | PASSIVE_LEVEL |