DXGKDDI_QUERY_CHILD_STATUS fungsi panggilan balik (dispmprt.h)

Artikel
05/23/2024

Fungsi DxgkDdiQueryChildStatus mengembalikan status perangkat anak individual dari adaptor tampilan.

Sintaks

DXGKDDI_QUERY_CHILD_STATUS DxgkddiQueryChildStatus;

NTSTATUS DxgkddiQueryChildStatus(
  [in]      IN_CONST_PVOID MiniportDeviceContext,
  [in, out] INOUT_PDXGK_CHILD_STATUS ChildStatus,
  [in]      IN_BOOLEAN NonDestructiveOnly
)
{...}

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] ChildStatus

Penunjuk ke struktur DXGK_CHILD_STATUS . Penelepon memasok ChildStatus-Type> dan ChildStatus-ChildUid>. Saat kembali, anggota struktur yang tersisa (serikat) menerima status yang diminta.

[in] NonDestructiveOnly

Nilai BOOLEAN yang menentukan apakah driver miniport tampilan diizinkan untuk menentukan status yang diminta dengan cara yang menyebabkan artefak visual. Jika pemanggil mengatur parameter ini ke TRUE, maka driver miniport tampilan tidak diizinkan untuk menyebabkan artefak. Jika pemanggil mengatur parameter ini ke FALSE, maka driver miniport tampilan diizinkan untuk menyebabkan artefak.

Menampilkan nilai

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

Keterangan

Selama inisialisasi, driver port tampilan memanggil DxgkDdiQueryChildRelations untuk mendapatkan daftar perangkat yang merupakan anak dari adaptor tampilan yang diwakili oleh MiniportDeviceContext. Kemudian untuk setiap anak yang memiliki nilai kesadaran HPD hpdAwarenessPolled atau HpdAwarenessInterruptible, driver port tampilan memanggil DxgkDdiQueryChildStatus untuk menentukan apakah anak saat ini memiliki perangkat keras (misalnya monitor) yang terhubung dengannya.

DxgkDdiQueryChildStatus harus melakukan tindakan berikut:

Jika ChildStatus->Type sama dengan StatusConnection, kembalikan nilai Boolean di ChildStatus->HotPlug.Connected. Mengembalikan TRUE jika perangkat anak yang diidentifikasi oleh ChildStatus->ChildUid memiliki perangkat keras eksternal yang terhubung ke perangkat tersebut; jika tidak, kembalikan FALSE.
Jika ChildStatus->Type sama dengan StatusRotation, kembalikan (di ChildStatus->Rotation.Angle) sudut rotasi untuk tampilan yang terhubung ke perangkat anak yang diidentifikasi oleh ChildStatus->ChildUid.

DxgkDdiQueryChildStatus harus dibuat dapat dipaginasi.