DXGKDDI_NOTIFY_ACPI_EVENT función de devolución de llamada (dispmprt.h)

  • Artículo

Notifica al controlador de minipuerto de pantalla sobre determinados eventos ACPI.

Sintaxis

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
)
{...}

Parámetros

[in] MiniportDeviceContext

Identificador de un bloque de contexto que representa un adaptador de pantalla. La función DxgkDdiAddDevice del controlador de miniporte de pantalla proporcionó anteriormente este identificador al subsistema del kernel de gráficos de DirectX.

[in] EventType

Enumerador DXGK_EVENT_TYPE que proporciona el tipo de evento (DpAcpiEvent, DpPowerStateEvent, DpDockingEvent).

[in] Event

Número de evento. En la tabla siguiente se enumeran los posibles números de evento para cada uno de los tipos de eventos.

Tipo de evento Posibles números de evento
DpAcpiEvent A continuación se muestran los eventos permitidos, tal como se define en Dispmprt.h:
  • ACPI_NOTIFY_CYCLE_DISPLAY_HOTKEY: notifica al sistema operativo que el usuario ha presionado la tecla de acceso rápido de la pantalla del ciclo.
  • ACPI_NOTIFY_DOCK_EVENT: indica que se ha producido un evento de acoplamiento. Por ejemplo, el usuario acoplado o desacoplar un equipo móvil.
  • ACPI_NOTIFY_DEVICE_HOTPLUG: indica que se ha cambiado el estado de cualquier dispositivo de salida conectado al controlador VGA. Por ejemplo, el usuario quitó o enchufó una pantalla CRT al puerto VGA.
  • ACPI_NOTIFY_PANEL_SWITCH: indica que se ha activado el estado de uno de los dispositivos de salida conectados al controlador VGA. Por ejemplo, el usuario cambió la pantalla de salida activa de LCD a tipo de pantalla CRT.
  • ACPI_NOTIFY_VIDEO_WAKEUP: indica que se ha reanudado la presentación de salida. Por ejemplo, el usuario ha reactivado la pantalla del equipo.
DpPowerStateEvent PO_CB_LID_SWITCH_STATE, PO_CB_AC_STATUS
Definido en Wdm.h.
DpDockingEvent ACPI_NOTIFY_DOCK_EVENT: indica que se ha producido un evento de acoplamiento. Por ejemplo, el usuario acoplado o desacoplar un equipo móvil.
Definido en Dispmprt.h.

[in] Argument

Puntero a un argumento que depende del evento. Para la mayoría de los eventos, será NULL. En la tabla siguiente se muestran los argumentos de evento, que son valores ULONG, para los números de evento especificados que están disponibles.

Número de evento Posibles argumentos de evento
PO_CB_AC_STATUS 0 - Indica que el sistema está encendido por batería.
1 - Indica que el sistema está encendido.
PO_CB_LID_SWITCH_STATE 0 : indica que la tapa se está cerrando.
1 - Indica que se está abriendo la tapa.

[out] AcpiFlags

Puntero a un valor que indica el tipo de solicitud que el controlador de miniporte de pantalla debe realizar en el sistema operativo. En la tabla siguiente se muestran los valores que se pueden especificar.

Valor Tipo de solicitud
DXGK_ACPI_CHANGE_DISPLAY_MODE El controlador de minipuerto de pantalla realiza una solicitud al sistema operativo para llamar a la función DxgkDdiRecommendFunctionalVidPn y, a continuación, para iniciar un cambio de modo a la nueva red de vídeo activa (VidPN) recomendada. Por ejemplo, el controlador de minipuerto de pantalla podría realizar esta solicitud si el usuario ha especificado un cambio de modo.
DXGK_ACPI_CHANGE_DISPLAY_TOPOLOGY
DXGK_ACPI_POLL_DISPLAY_CHILDREN El controlador de minipuerto de pantalla realiza una solicitud al sistema operativo para sondear la conectividad de los elementos secundarios del adaptador de pantalla representado por MiniportDeviceContext.
DXGK_ACPI_CHAIN_NOT_HANDLED Indica que el controlador discreto híbrido no controló un evento con el tipo DxgkChainedAcpiEvent y, por tanto, debe enviarse al controlador integrado híbrido.

Este parámetro se omite si esta función devuelve un error o si el adaptador de pantalla pierde energía.

Valor devuelto

DxgkDdiNotifyAcpiEvent devuelve STATUS_SUCCESS si se realiza correctamente; de lo contrario, devuelve uno de los códigos de error definidos en Ntstatus.h.

Comentarios

DxgkDdiNotifyAcpiEvent es una función de controlador de minipuerto de pantalla opcional.

DxgkDdiNotifyAcpiEvent debe ser paginable.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista
Plataforma de destino Escritorio
Encabezado dispmprt.h
IRQL PASSIVE_LEVEL

Consulte también

DxgkCbEvalAcpiMethod