DXGKDDI_NOTIFY_ACPI_EVENT callback function (dispmprt.h)
Notifies the display miniport driver about certain ACPI events.
Syntax
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
)
{...}
Parameters
[in] MiniportDeviceContext
A handle to a context block that represents a display adapter. The display miniport driver's DxgkDdiAddDevice function previously provided this handle to the DirectX graphics kernel subsystem.
[in] EventType
A DXGK_EVENT_TYPE enumerator that supplies the event type (DpAcpiEvent, DpPowerStateEvent, DpDockingEvent).
[in] Event
The event number. The following table lists the possible event numbers for each of the event types.
Event type | Possible event numbers |
---|---|
DpAcpiEvent | The following are the allowed events as defined in Dispmprt.h:
|
DpPowerStateEvent | PO_CB_LID_SWITCH_STATE, PO_CB_AC_STATUS Defined in Wdm.h. |
DpDockingEvent | ACPI_NOTIFY_DOCK_EVENT - Indicates that a docking event has occurred. For example, the user docked or undocked a mobile computer. Defined in Dispmprt.h. |
[in] Argument
A pointer to an argument that depends on the event. For most events, this will be NULL. The following table shows the event arguments, which are ULONG values, for specified event numbers that are available.
Event number | Possible event arguments |
---|---|
PO_CB_AC_STATUS | 0 - Indicates that the system is on battery power. 1 - Indicates that the system is on AC power. |
PO_CB_LID_SWITCH_STATE | 0 - Indicates that the lid is being closed. 1 - Indicates that the lid is being opened. |
[out] AcpiFlags
A pointer to a value that indicates the type of request that the display miniport driver should make to the operating system. The following table shows the values that can be specified.
Value | Request type |
---|---|
DXGK_ACPI_CHANGE_DISPLAY_MODE | The display miniport driver makes a request to the operating system to call the DxgkDdiRecommendFunctionalVidPn function and then to initiate a mode change to the new recommended active video present network (VidPN). For example, the display miniport driver might make this request if the user has specified a mode change. |
DXGK_ACPI_CHANGE_DISPLAY_TOPOLOGY | |
DXGK_ACPI_POLL_DISPLAY_CHILDREN | The display miniport driver makes a request to the operating system to poll the connectivity of the children of the display adapter represented by MiniportDeviceContext. |
DXGK_ACPI_CHAIN_NOT_HANDLED | Indicates that an event with type DxgkChainedAcpiEvent was not handled by the hybrid discrete driver and should therefore be sent to the hybrid integrated driver. |
This parameter is ignored if this function returns an error or if the display adapter loses power.
Return value
DxgkDdiNotifyAcpiEvent returns STATUS_SUCCESS if it succeeds; otherwise, it returns one of the error codes defined in Ntstatus.h.
Remarks
DxgkDdiNotifyAcpiEvent is an optional display miniport driver function.
DxgkDdiNotifyAcpiEvent should be made pageable.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows Vista |
Target Platform | Desktop |
Header | dispmprt.h |
IRQL | PASSIVE_LEVEL |