Funzione di callback DXGKDDISETPOWERCOMPONENTFSTATE (d3dkmddi.h)

Articolo
03/08/2023

Chiamato dal sottosistema kernel grafico Microsoft DirectX per eseguire la transizione di un componente di alimentazione a uno stato di inattività (uno stato F).

Sintassi

DXGKDDISETPOWERCOMPONENTFSTATE Dxgkddisetpowercomponentfstate;

NTSTATUS Dxgkddisetpowercomponentfstate(
  IN_CONST_HANDLE DriverContext,
  UINT ComponentIndex,
  UINT FState
)
{...}

Parametri

DriverContext

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

ComponentIndex

Indice del componente di alimentazione specificato da DXGKARG_QUERYADAPTERINFO. pInputData in una chiamata alla funzione DxgkDdiQueryAdapterInfo .

FState

Valore di stato F segnalato dal driver miniport di visualizzazione al sottosistema kernel della grafica DirectX.

Valore restituito

Restituisce STATUS_SUCCESS se ha esito positivo; in caso contrario, restituisce STATUS_INVALID_PARAMETER.

Commenti

Il sistema operativo chiama DxgkDdiSetPowerComponentFState solo se il driver miniport di visualizzazione indica il supporto impostando DXGK_DRIVERCAPS. SupportRuntimePowerManagement su TRUE.

Nota Per evitare un possibile deadlock, non chiamare la funzione DxgkCbSetPowerComponentActive fino a quando non viene restituita questa funzione.

Quando il driver miniport di visualizzazione esegue la transizione di un componente di alimentazione dallo stato F0 (completamente attivo) a un altro stato F, deve salvare il contesto necessario per ripristinare in seguito il componente nello stato F0.

Power Management Framework esegue solo la transizione di un componente allo stato F0 o .

Questa funzione può essere chiamata simultaneamente da più thread di esecuzione. Tuttavia, solo un thread alla volta può chiamare questa funzione per controllare un determinato componente.

Il sistema operativo garantisce che questa funzione segua la modalità di sincronizzazione a livello zero, come definito in Threading e Synchronization Zero Level.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8
Server minimo supportato	Windows Server 2012
Piattaforma di destinazione	Desktop
Intestazione	d3dkmddi.h
IRQL	<=DISPATCH_LEVEL