DXGKDDI_NOTIFY_ACPI_EVENT fungsi panggilan balik (dispmprt.h)

Artikel
05/23/2024

Memberi tahu driver miniport tampilan tentang peristiwa ACPI tertentu.

Sintaks

DXGKDDI_NOTIFY_ACPI_EVENT DxgkddiNotifyAcpiEvent;

NTSTATUS DxgkddiNotifyAcpiEvent(
  [in]  IN_CONST_PVOID MiniportDeviceContext,
  [in]  IN_DXGK_EVENT_TYPE EventType,
  [in]  IN_ULONG Event,
  [in]  IN_PVOID Argument,
  [out] OUT_PULONG AcpiFlags
)
{...}

Parameter

[in] MiniportDeviceContext

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

[in] EventType

Enumerator DXGK_EVENT_TYPE yang memasok jenis peristiwa (DpAcpiEvent, DpPowerStateEvent, DpDockingEvent).

[in] Event

Nomor peristiwa. Tabel berikut mencantumkan kemungkinan nomor peristiwa untuk setiap jenis peristiwa.

Jenis peristiwa	Kemungkinan nomor peristiwa
DpAcpiEvent	Berikut ini adalah peristiwa yang diizinkan seperti yang didefinisikan dalam Dispmprt.h: ACPI_NOTIFY_CYCLE_DISPLAY_HOTKEY - Ini memberi tahu sistem operasi bahwa pengguna telah menekan tombol cepat tampilan siklus. ACPI_NOTIFY_DOCK_EVENT - Menunjukkan bahwa peristiwa docking telah terjadi. Misalnya, pengguna menambah atau melepas dok komputer seluler. ACPI_NOTIFY_DEVICE_HOTPLUG - Menunjukkan bahwa status perangkat output apa pun yang terpasang pada pengontrol VGA telah diubah. Misalnya, pengguna menghapus atau menyambungkan tampilan CRT ke port VGA. ACPI_NOTIFY_PANEL_SWITCH - Menunjukkan bahwa status salah satu perangkat output yang terpasang pada pengontrol VGA telah dialihkan. Misalnya, pengguna mengalihkan tampilan output aktif dari LCD ke jenis tampilan CRT. ACPI_NOTIFY_VIDEO_WAKEUP - Menunjukkan bahwa tampilan output telah dilanjutkan. Misalnya, pengguna telah mengaktifkan kembali tampilan komputer.
DpPowerStateEvent	PO_CB_LID_SWITCH_STATE, PO_CB_AC_STATUS Ditentukan dalam Wdm.h.
DpDockingEvent	ACPI_NOTIFY_DOCK_EVENT - Menunjukkan bahwa peristiwa docking telah terjadi. Misalnya, pengguna menambah atau melepas dok komputer seluler. Ditentukan dalam Dispmprt.h.

[in] Argument

Penunjuk ke argumen yang bergantung pada peristiwa. Untuk sebagian besar peristiwa, ini akan menjadi NULL. Tabel berikut ini memperlihatkan argumen peristiwa, yang merupakan nilai ULONG, untuk nomor peristiwa tertentu yang tersedia.

Nomor kejadian	Kemungkinan argumen peristiwa
PO_CB_AC_STATUS	0 - Menunjukkan bahwa sistem menggunakan daya baterai. 1 - Menunjukkan bahwa sistem berada pada daya AC.
PO_CB_LID_SWITCH_STATE	0 - Menunjukkan bahwa tutup sedang ditutup. 1 - Menunjukkan bahwa tutup sedang dibuka.

[out] AcpiFlags

Pointer ke nilai yang menunjukkan jenis permintaan yang harus dibuat driver miniport tampilan ke sistem operasi. Tabel berikut ini memperlihatkan nilai yang bisa ditentukan.

Nilai	Jenis permintaan
DXGK_ACPI_CHANGE_DISPLAY_MODE	Driver miniport tampilan membuat permintaan ke sistem operasi untuk memanggil fungsi DxgkDdiRecommendFunctionalVidPn dan kemudian untuk memulai perubahan mode ke jaringan sajikan video aktif baru yang direkomendasikan (VidPN). Misalnya, driver miniport tampilan mungkin membuat permintaan ini jika pengguna telah menentukan perubahan mode.
DXGK_ACPI_CHANGE_DISPLAY_TOPOLOGY
DXGK_ACPI_POLL_DISPLAY_CHILDREN	Driver miniport tampilan membuat permintaan ke sistem operasi untuk melakukan polling konektivitas anak-anak adaptor tampilan yang diwakili oleh MiniportDeviceContext.
DXGK_ACPI_CHAIN_NOT_HANDLED	Menunjukkan bahwa peristiwa dengan jenis DxgkChainedAcpiEvent tidak ditangani oleh driver diskrit hibrid dan karenanya harus dikirim ke driver terintegrasi hibrid.

Parameter ini diabaikan jika fungsi ini mengembalikan kesalahan atau jika adaptor tampilan kehilangan daya.

Menampilkan nilai

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

Keterangan

DxgkDdiNotifyAcpiEvent adalah fungsi driver miniport tampilan opsional.

DxgkDdiNotifyAcpiEvent harus dibuat dapat dipaginasi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Target Platform	Desktop
Header	dispmprt.h
IRQL	PASSIVE_LEVEL

Lihat juga

DxgkCbEvalAcpiMethod

Bagikan melalui