Função de retorno de chamada DXGKDDISETPOWERCOMPONENTFSTATE (d3dkmddi.h)

Artigo
02/06/2025

Chamado pelo subsistema de kernel de 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 miniporto de exibição anteriormente forneceu esse identificador para o subsistema de kernel de elementos gráficos DirectX.

ComponentIndex

O índice de 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.

Valor de retorno

Retorna STATUS_SUCCESS se tiver êxito; caso contrário, ele retornará STATUS_INVALID_PARAMETER.

Observações

O sistema operacional chama DxgkDdiSetPowerComponentFState somente se o driver de miniporto de exibição indicar suporte definindo DXGK_DRIVERCAPS.supportRuntimePowerManagement para true.

Observação Para evitar um possível deadlock, não chame a função DxgkCbSetPowerComponentActive até que essa função seja retornada.

Quando o driver do miniporto de exibição faz a transição de um componente de energia do estado F0 (totalmente ativado) para outro estado F, ele deve salvar o contexto necessário para restaurar posteriormente o componente para o estado F0.

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 de cada 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 de Nível Zero de Threading e Sincronização.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 8
servidor com suporte mínimo	Windows Server 2012
da Plataforma de Destino	Área de trabalho
cabeçalho	d3dkmddi.h
IRQL	<=DISPATCH_LEVEL