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 中定義的允許事件：
|
| 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 |