Função de retorno de chamada DXGKDDISETPOWERCOMPONENTFSTATE (d3dkmddi.h)
Chamado pelo subsistema de kernel de elementos gráficos do Microsoft DirectX para fazer a transição de um componente de energia para um estado ocioso (um estado F).
Sintaxe
DXGKDDISETPOWERCOMPONENTFSTATE Dxgkddisetpowercomponentfstate;
NTSTATUS Dxgkddisetpowercomponentfstate(
IN_CONST_HANDLE DriverContext,
UINT ComponentIndex,
UINT FState
)
{...}
Parâmetros
DriverContext
Um identificador para um bloco de contexto associado a 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.
ComponentIndex
O índice do componente de energia especificado por DXGKARG_QUERYADAPTERINFO. pInputData em uma chamada para a função DxgkDdiQueryAdapterInfo .
FState
Um valor de estado F que o driver de miniporto de exibição relatou ao subsistema de kernel de elementos gráficos DirectX.
Retornar valor
Retorna STATUS_SUCCESS se for bem-sucedido; caso contrário, retornará STATUS_INVALID_PARAMETER.
Comentários
O sistema operacional chamará DxgkDdiSetPowerComponentFState somente se o driver de miniporto de exibição indicar suporte definindo DXGK_DRIVERCAPS. SupportRuntimePowerManagement para TRUE.
O Power Management Framework faz a transição apenas de um componente para ou do estado F0.
Essa função pode ser chamada simultaneamente de vários threads de execução. No entanto, apenas um thread por vez pode chamar essa função para controlar um componente específico.
O sistema operacional garante que essa função siga o modo de sincronização de nível zero, conforme definido em Threading e Sincronização Nível Zero.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 |
| Servidor mínimo com suporte | Windows Server 2012 |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | d3dkmddi.h |
| IRQL | <=DISPATCH_LEVEL |