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 中定义的允许事件：
|
| 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 - 指示系统处于 AC 电源。 |
| 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 |