DXGKDDI_NOTIFY_ACPI_EVENT funzione di callback (dispmprt.h)
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 | Possibili numeri di evento |
---|---|
DpAcpiEvent | Di seguito sono riportati gli eventi consentiti definiti in Dispmprt.h:
|
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, questo sarà NULL. La tabella seguente illustra gli argomenti dell'evento, ovvero valori ULONG, per i numeri di evento specificati disponibili.
Numero evento | Possibili argomenti dell'evento |
---|---|
PO_CB_AC_STATUS | 0 - Indica che il sistema è alimentato a batteria. 1 - Indica che il sistema è in alimentazione AC. |
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 di avviare una modifica della modalità al nuovo video attivo consigliato (VidPN). Ad esempio, il driver 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.
Commenti
DxgkDdiNotifyAcpiEvent è una funzione di driver miniport di visualizzazione facoltativa.
DxgkDdiNotifyAcpiEvent deve essere reso pageable.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows Vista |
Piattaforma di destinazione | Desktop |
Intestazione | dispmprt.h |
IRQL | PASSIVE_LEVEL |