共用方式為

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

提供DpAcpiEvent、DpPowerStateEvent、DpDockingEvent () 事件類型的DXGK_EVENT_TYPE列舉值。

[in] Event

事件編號。 下表列出每個事件類型的可能事件編號。

事件類型 可能的事件號碼
DpAcpiEvent 以下是 Dispmprt.h 中定義的允許事件：
  • ACPI_NOTIFY_CYCLE_DISPLAY_HOTKEY - 通知作業系統使用者已按下循環顯示熱鍵。
  • ACPI_NOTIFY_DOCK_EVENT - 指出已發生停駐事件。 例如，使用者停駐或取消停駐行動計算機。
  • ACPI_NOTIFY_DEVICE_HOTPLUG - 指出已變更連結至 VGA 控制器的任何輸出裝置狀態。 例如，使用者已移除或插入CRT顯示器至VGA埠。
  • ACPI_NOTIFY_PANEL_SWITCH - 指出已切換連結至 VGA 控制器的其中一個輸出裝置狀態。 例如，使用者已將作用中輸出顯示從[LED] 切換為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 - 指出系統處於 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

另請參閱

DxgkCbEvalAcpiMethod