DXGKCB_SETPOWERCOMPONENTACTIVE função de retorno de chamada (d3dkmddi.h)
Um driver de miniporto 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 DeviceHandle membro da estrutura DXGKRNL_INTERFACE em uma chamada para sua função DxgkDdiStartDevice.
[in] ComponentIndex
O índice de componente de energia especificado por DXGKARG_QUERYADAPTERINFO.pInputData em uma chamada para a função DxgkDdiQueryAdapterInfo.
Valor de retorno
Nenhum
Observações
Cada chamada para essa função deve ser emparelhada com uma chamada à 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 |
|---|---|
| de cliente com suporte mínimo | Windows 8 (WDDM 1.2) |
| servidor com suporte mínimo | Windows Server 2012 |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | d3dkmddi.h (inclua D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |