DXGKDDI_NOTIFY_ACPI_EVENT função de retorno de chamada (dispmprt.h)

  • Artigo

Notifica o driver de miniporto de exibição sobre determinados eventos ACPI.

Sintaxe

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

Um identificador para um bloco de contexto que representa um adaptador de exibição. A função DxgkDdiAddDevice do driver de miniporta de exibição forneceu anteriormente esse identificador para o subsistema de kernel de elementos gráficos DirectX.

[in] EventType

Um enumerador DXGK_EVENT_TYPE que fornece o tipo de evento (DpAcpiEvent, DpPowerStateEvent, DpDockingEvent).

[in] Event

O número do evento. A tabela a seguir lista os possíveis números de evento para cada um dos tipos de evento.

Tipo de evento Números de evento possíveis
DpAcpiEvent Veja a seguir os eventos permitidos conforme definido em Dispmprt.h:
  • ACPI_NOTIFY_CYCLE_DISPLAY_HOTKEY - Ele notifica o sistema operacional de que o usuário pressionou a tecla de acesso de exibição do ciclo.
  • ACPI_NOTIFY_DOCK_EVENT - Indica que ocorreu um evento de encaixe. Por exemplo, o usuário acoplou ou desencaixou um computador móvel.
  • ACPI_NOTIFY_DEVICE_HOTPLUG - Indica que o status de qualquer dispositivo de saída anexado ao controlador VGA foi alterado. Por exemplo, o usuário removeu ou conectou uma tela CRT à porta VGA.
  • ACPI_NOTIFY_PANEL_SWITCH - Indica que o status de um dos dispositivos de saída anexados ao controlador VGA foi alternado. Por exemplo, o usuário alternou a exibição de saída ativa do LCD para o tipo de exibição CRT.
  • ACPI_NOTIFY_VIDEO_WAKEUP - Indica que a exibição de saída foi retomada. Por exemplo, o usuário reativou a exibição do computador.
DpPowerStateEvent PO_CB_LID_SWITCH_STATE, PO_CB_AC_STATUS
Definido em Wdm.h.
DpDockingEvent ACPI_NOTIFY_DOCK_EVENT - Indica que ocorreu um evento de encaixe. Por exemplo, o usuário acoplou ou desencaixou um computador móvel.
Definido em Dispmprt.h.

[in] Argument

Um ponteiro para um argumento que depende do evento. Para a maioria dos eventos, isso será NULL. A tabela a seguir mostra os argumentos de evento, que são valores ULONG, para números de evento especificados que estão disponíveis.

Número do evento Possíveis argumentos de evento
PO_CB_AC_STATUS 0 – Indica que o sistema está com energia da bateria.
1 – Indica que o sistema está na alimentação AC.
PO_CB_LID_SWITCH_STATE 0 – Indica que a tampa está sendo fechada.
1 – Indica que a tampa está sendo aberta.

[out] AcpiFlags

Um ponteiro para um valor que indica o tipo de solicitação que o driver de miniporto de exibição deve fazer ao sistema operacional. A tabela a seguir mostra os valores que podem ser especificados.

Valor Tipo de solicitação
DXGK_ACPI_CHANGE_DISPLAY_MODE O driver de miniporto de exibição faz uma solicitação ao sistema operacional para chamar a função DxgkDdiRecommendFunctionalVidPn e, em seguida, iniciar uma alteração de modo para a nova VidPN (rede presente de vídeo ativa) recomendada. Por exemplo, o driver de miniporto de exibição poderá fazer essa solicitação se o usuário tiver especificado uma alteração de modo.
DXGK_ACPI_CHANGE_DISPLAY_TOPOLOGY
DXGK_ACPI_POLL_DISPLAY_CHILDREN O driver de miniporto de exibição faz uma solicitação ao sistema operacional para sondar a conectividade dos filhos do adaptador de vídeo representado por MiniportDeviceContext.
DXGK_ACPI_CHAIN_NOT_HANDLED Indica que um evento com o tipo DxgkChainedAcpiEvent não foi manipulado pelo driver discreto híbrido e, portanto, deve ser enviado para o driver integrado híbrido.

Esse parâmetro será ignorado se essa função retornar um erro ou se o adaptador de exibição perder energia.

Retornar valor

DxgkDdiNotifyAcpiEvent retornará STATUS_SUCCESS se tiver êxito; caso contrário, ele retornará um dos códigos de erro definidos em Ntstatus.h.

Comentários

DxgkDdiNotifyAcpiEvent é uma função de driver de miniporto de exibição opcional.

DxgkDdiNotifyAcpiEvent deve ser tornado paginável.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Plataforma de Destino Área de Trabalho
Cabeçalho dispmprt.h
IRQL PASSIVE_LEVEL

Confira também

DxgkCbEvalAcpiMethod