DXGKCB_SETPOWERCOMPONENTACTIVE função de retorno de chamada (d3dkmddi.h)
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 |