DXGKCB_SETPOWERCOMPONENTIDLE função de retorno de chamada (d3dkmddi.h)
Um driver de miniporto 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 miniporto 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 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
O driver de miniporto 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 |
|---|---|
| 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 | Consulte a seção Comentários. |