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

Um driver de miniporto de exibição no modo kernel chama DXGKCB_SETPOWERCOMPONENTRESIDENCY para definir a residência esperada para um componente de energia do tipo DXGK_POWER_COMPONENT_OTHER.

Sintaxe

DXGKCB_SETPOWERCOMPONENTRESIDENCY DxgkcbSetpowercomponentresidency;

void DxgkcbSetpowercomponentresidency(
  [in] IN_CONST_HANDLE hAdapter,
  [in] UINT ComponentIndex,
  [in] ULONGLONG Residency
)
{...}

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 .

[in] Residency

A residência esperada - o tempo máximo, em unidades de 100 nanossegundos - que o driver de miniporto de exibição espera que um componente de energia permaneça ocioso depois que ele entrar em um estado ocioso. O Power Management Framework usa essas informações para selecionar um estado ocioso apropriado para o componente que não viola a residência solicitada. A residência esperada especificada pela Residência permanece em vigor até que o driver chame essa função novamente para atualizá-la. Consulte Observações.

Valor retornado

Nenhum

Comentários

Observação

O driver de miniporto de exibição deve chamar essa função somente se o tipo de componente for DXGK_POWER_COMPONENT_OTHER. O subsistema de kernel de elementos gráficos DirectX define o valor de residência esperado para outros tipos de componente.

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

Se o componente de energia estiver em um estado ocioso quando essa função for chamada, o Power Management Framework poderá alterar o estado F do componente para atender ao valor de residência esperado especificado pela Residência.

Se o driver definir Residência como um valor de PO_FX_UNKNOWN_TIME (definido em Wdm.h), o PLUG-in do Power Engine (PEP) poderá não conseguir definir o componente como um estado F inferior a F0.

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	<= DISPATCH_LEVEL

Confira também

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DxgkDdiQueryAdapterInfo

DxgkDdiStartDevice