Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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 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.
[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 entra 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 pelo de Residência permanece em vigor até que o driver chame essa função novamente para atualizá-la. Consulte Comentários.
Valor de retorno
Nenhum
Observações
Nota
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 por de Residência.
Se o driver definir de Residência como um valor de PO_FX_UNKNOWN_TIME (definido em Wdm.h), o PEP (Plug-in do Power Engine) poderá não conseguir definir o componente como um estado F inferior a F0.
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 | <= DISPATCH_LEVEL |