DXGKDDI_NOTIFY_ACPI_EVENT funzione di callback (dispmprt.h)

Articolo
02/06/2025

Notifica al driver miniport di visualizzazione di determinati eventi ACPI.

Sintassi

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

Parametri

[in] MiniportDeviceContext

Handle di un blocco di contesto che rappresenta una scheda di visualizzazione. La funzione DxgkDdiAddDevice del driver miniport di visualizzazione ha fornito in precedenza questo handle al sottosistema del kernel grafico DirectX.

[in] EventType

Enumeratore DXGK_EVENT_TYPE che fornisce il tipo di evento (DpAcpiEvent, DpPowerStateEvent, DpDockingEvent).

[in] Event

Numero dell'evento. Nella tabella seguente sono elencati i numeri di evento possibili per ognuno dei tipi di evento.

Tipo di evento	Numeri di evento possibili
DpAcpiEvent	Di seguito sono riportati gli eventi consentiti definiti in Dispmprt.h: ACPI_NOTIFY_CYCLE_DISPLAY_HOTKEY: notifica al sistema operativo che l'utente ha premuto il tasto di scelta rapida per la visualizzazione del ciclo. ACPI_NOTIFY_DOCK_EVENT - Indica che si è verificato un evento di ancoraggio. Ad esempio, l'utente ancorato o scollegato un computer mobile. ACPI_NOTIFY_DEVICE_HOTPLUG - Indica che lo stato di qualsiasi dispositivo di output collegato al controller VGA è stato modificato. Ad esempio, l'utente ha rimosso o collegato una visualizzazione CRT alla porta VGA. ACPI_NOTIFY_PANEL_SWITCH - Indica che lo stato di uno dei dispositivi di output collegati al controller VGA è stato attivato o disattivato. Ad esempio, l'utente ha cambiato la visualizzazione dell'output attivo da LCD a tipo di visualizzazione CRT. ACPI_NOTIFY_VIDEO_WAKEUP - Indica che la visualizzazione dell'output è stata ripresa. Ad esempio, l'utente ha riattivato la visualizzazione del computer.
DpPowerStateEvent	PO_CB_LID_SWITCH_STATE, PO_CB_AC_STATUS Definito in Wdm.h.
DpDockingEvent	ACPI_NOTIFY_DOCK_EVENT - Indica che si è verificato un evento di ancoraggio. Ad esempio, l'utente ancorato o scollegato un computer mobile. Definito in Dispmprt.h.

[in] Argument

Puntatore a un argomento che dipende dall'evento. Per la maggior parte degli eventi, verrà NULL. Nella tabella seguente vengono illustrati gli argomenti dell'evento, ovvero valori ULONG, per i numeri di evento specificati disponibili.

Numero evento	Argomenti di evento possibili
PO_CB_AC_STATUS	0 - Indica che il sistema è alimentato a batteria. 1 - Indica che il sistema è acceso.
PO_CB_LID_SWITCH_STATE	0 - Indica che il coperchio è chiuso. 1 - Indica che il coperchio è aperto.

[out] AcpiFlags

Puntatore a un valore che indica il tipo di richiesta che il driver miniport di visualizzazione deve effettuare al sistema operativo. Nella tabella seguente vengono illustrati i valori che è possibile specificare.

valore	Tipo di richiesta
DXGK_ACPI_CHANGE_DISPLAY_MODE	Il driver miniport di visualizzazione effettua una richiesta al sistema operativo di chiamare la funzione DxgkDdiRecommendFunctionalVidPn e quindi per avviare una modifica della modalità alla nuova rete di presentazione video attiva consigliata (VidPN). Ad esempio, il driver di miniport di visualizzazione potrebbe effettuare questa richiesta se l'utente ha specificato una modifica della modalità.
DXGK_ACPI_CHANGE_DISPLAY_TOPOLOGY
DXGK_ACPI_POLL_DISPLAY_CHILDREN	Il driver miniport di visualizzazione effettua una richiesta al sistema operativo di eseguire il polling della connettività degli elementi figlio della scheda di visualizzazione rappresentata da MiniportDeviceContext.
DXGK_ACPI_CHAIN_NOT_HANDLED	Indica che un evento con tipo DxgkChainedAcpiEvent non è stato gestito dal driver discreto ibrido e deve quindi essere inviato al driver integrato ibrido.

Questo parametro viene ignorato se questa funzione restituisce un errore o se l'adattatore di visualizzazione perde l'alimentazione.

Valore restituito

DxgkDdiNotifyAcpiEvent restituisce STATUS_SUCCESS se ha esito positivo; in caso contrario, restituisce uno dei codici di errore definiti in Ntstatus.h.

Osservazioni

DxgkDdiNotifyAcpiEvent è una funzione di driver miniport di visualizzazione facoltativa.

il DxgkDdiNotifyAcpiEvent deve essere reso pageable.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista
piattaforma di destinazione	Desktop
intestazione	dispmprt.h
IRQL	PASSIVE_LEVEL

Vedere anche

DxgkCbEvalAcpiMethod

Condividi tramite