DXGKDDI_NOTIFY_ACPI_EVENT回调函数 (dispmprt.h)

通知显示微型端口驱动程序某些 ACPI 事件。

语法

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
)
{...}

参数

[in] MiniportDeviceContext

表示显示适配器的上下文块的句柄。 显示微型端口驱动程序的 DxgkDdiAddDevice 函数以前将此句柄提供给 DirectX 图形内核子系统。

[in] EventType

一个 DXGK_EVENT_TYPE 枚举器，它提供事件类型 (DpAcpiEvent、 DpPowerStateEvent、 DpDockingEvent) 。

[in] Event

事件编号。 下表列出了每种事件类型的可能事件编号。

事件类型	可能的事件编号
DpAcpiEvent	以下是 Dispmprt.h 中定义的允许事件： ACPI_NOTIFY_CYCLE_DISPLAY_HOTKEY - 它通知操作系统用户已按循环显示热键。 ACPI_NOTIFY_DOCK_EVENT - 指示已发生停靠事件。 例如，用户停靠或取消停靠移动计算机。 ACPI_NOTIFY_DEVICE_HOTPLUG - 指示已更改附加到 VGA 控制器的任何输出设备的状态。 例如，用户删除或插入了 VGA 端口的 CRT 显示器。 ACPI_NOTIFY_PANEL_SWITCH - 指示已切换连接到 VGA 控制器的某个输出设备的状态。 例如，用户将活动输出显示器从 LCD 切换为 CRT 显示类型。 ACPI_NOTIFY_VIDEO_WAKEUP - 指示输出显示已恢复。 例如，用户已重新激活计算机显示器。
DpPowerStateEvent	PO_CB_LID_SWITCH_STATE、PO_CB_AC_STATUS 在 Wdm.h 中定义。
DpDockingEvent	ACPI_NOTIFY_DOCK_EVENT - 指示已发生停靠事件。 例如，用户停靠或取消停靠移动计算机。 在 Dispmprt.h 中定义。

[in] Argument

指向依赖于 事件的参数的指针。 对于大多数事件，此值为 NULL。 下表显示了可用的指定事件编号的事件参数（ULONG 值）。

事件号	可能的事件参数
PO_CB_AC_STATUS	0 - 指示系统使用电池电量。 1 - 指示系统使用交流电源。
PO_CB_LID_SWITCH_STATE	0 - 指示盖子正在关闭。 1 - 指示盖子正在打开。

[out] AcpiFlags

指向值的指针，该值指示显示微型端口驱动程序应向操作系统发出的请求类型。 下表显示了可以指定的值。

值	请求类型
DXGK_ACPI_CHANGE_DISPLAY_MODE	显示微型端口驱动程序向操作系统发出请求，以调用 DxgkDdiRecommendFunctionalVidPn 函数，然后启动对新建议的活动视频呈现网络 (VidPN) 的模式更改。 例如，如果用户指定了模式更改，则显示微型端口驱动程序可能会发出此请求。
DXGK_ACPI_CHANGE_DISPLAY_TOPOLOGY
DXGK_ACPI_POLL_DISPLAY_CHILDREN	显示微型端口驱动程序向操作系统发出请求，以轮询 MiniportDeviceContext 表示的显示适配器的子级连接。
DXGK_ACPI_CHAIN_NOT_HANDLED	指示类型为 DxgkChainedAcpiEvent 的事件未由混合离散驱动程序处理，因此应发送到混合集成驱动程序。

如果此函数返回错误或显示适配器断电，则忽略此参数。

返回值

DxgkDdiNotifyAcpiEvent 如果成功，则返回STATUS_SUCCESS;否则，它将返回 Ntstatus.h 中定义的错误代码之一。

注解

DxgkDdiNotifyAcpiEvent 是可选的显示微型端口驱动程序函数。

DxgkDdiNotifyAcpiEvent 应可分页。

要求

要求	值
最低受支持的客户端	Windows Vista
目标平台	桌面
标头	dispmprt.h
IRQL	PASSIVE_LEVEL

另请参阅

DxgkCbEvalAcpiMethod