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 - 指示系统使用交流电源。 |
| 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 |