DXGKCB_SETPOWERCOMPONENTACTIVE função de retorno de chamada (d3dkmddi.h)

Artigo
02/23/2024

Um driver de miniporte de exibição chama DXGKCB_SETPOWERCOMPONENTACTIVE para acessar um componente de energia. Depois que essa função retorna, o driver de miniporto de exibição pode alterar as configurações de hardware do componente.

Sintaxe

DXGKCB_SETPOWERCOMPONENTACTIVE DxgkcbSetpowercomponentactive;

void DxgkcbSetpowercomponentactive(
  [in] IN_CONST_HANDLE hAdapter,
  [in] UINT ComponentIndex
)
{...}

Parâmetros

[in] hAdapter

Um identificador para o adaptador de exibição. O driver de miniporto de exibição recebe o identificador do membro DeviceHandle da estrutura DXGKRNL_INTERFACE em uma chamada para sua função DxgkDdiStartDevice .

[in] ComponentIndex

O índice do componente de energia especificado por DXGKARG_QUERYADAPTERINFO. pInputData em uma chamada para a função DxgkDdiQueryAdapterInfo .

Retornar valor

Nenhum

Comentários

Cada chamada para essa função deve ser emparelhada com uma chamada para a função DXGKCB_SETPOWERCOMPONENTIDLE para indicar que o hardware do componente não é mais necessário.

Quando essa função é chamada, a contagem de referência ativa do componente é aumentada em 1. O Power Management Framework mantém a contagem de referência e coloca o componente em um estado F inferior somente quando a contagem de referência se torna zero.

Ao chamar essa função, o driver de miniporto de exibição pode receber uma chamada para a função DxgkDdiSetPowerComponentFState em outro thread de execução.

DXGKCB_XXX funções são implementadas por Dxgkrnl. Para usar essa função de retorno de chamada, chame DxgkCbSetPowerComponentActive por meio do DXGKRNL_INTERFACE.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 (WDDM 1.2)
Servidor mínimo com suporte	Windows Server 2012
Plataforma de Destino	Área de Trabalho
Cabeçalho	d3dkmddi.h (inclua D3dkmddi.h)
IRQL	PASSIVE_LEVEL