DXGKCB_SETPOWERCOMPONENTIDLE função de retorno de chamada (d3dkmddi.h)
Um driver de miniporta de exibição chama DXGKCB_SETPOWERCOMPONENTIDLE para notificar o subsistema de kernel de elementos gráficos DirectX de que um componente de energia não é mais necessário. Depois que essa função retorna, o driver de miniporta de exibição não deve alterar as configurações de hardware do componente.
Sintaxe
DXGKCB_SETPOWERCOMPONENTIDLE DxgkcbSetpowercomponentidle;
void DxgkcbSetpowercomponentidle(
[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
O driver de miniporta de exibição pode chamar essa função para qualquer tipo de componente de energia, mesmo que o subsistema de kernel de elementos gráficos DirectX gerencie o estado ocioso do componente.
DXGKCB_XXX funções são implementadas por Dxgkrnl. Para usar essa função de retorno de chamada, chame DxgkCbSetPowerComponentIdle por meio do DXGKRNL_INTERFACE. Cada chamada para essa função deve ser emparelhada com uma chamada para a função DXGKCB_SETPOWERCOMPONENTACTIVE .
Quando essa função é chamada, a contagem de referência ativa do componente é reduzida 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.
Essa função deve ser chamada em IRQL <= DISPATCH_LEVEL. Ele pode ser chamado em IRQL = DISPATCH_LEVEL somente se o tipo de componente for DXGK_POWER_COMPONENT_OTHER.
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 | Consulte a seção Observações. |