DXGKCB_SETPOWERCOMPONENTRESIDENCY función de devolución de llamada (d3dkmddi.h)
Un controlador de miniporte de pantalla en modo kernel llama a DXGKCB_SETPOWERCOMPONENTRESIDENCY para establecer la residencia esperada para un componente de potencia de tipo DXGK_POWER_COMPONENT_OTHER.
Sintaxis
DXGKCB_SETPOWERCOMPONENTRESIDENCY DxgkcbSetpowercomponentresidency;
void DxgkcbSetpowercomponentresidency(
[in] IN_CONST_HANDLE hAdapter,
[in] UINT ComponentIndex,
[in] ULONGLONG Residency
)
{...}
Parámetros
[in] hAdapter
Identificador del adaptador de pantalla. El controlador de miniporte de pantalla recibe el identificador del miembro DeviceHandle de la estructura DXGKRNL_INTERFACE en una llamada a su función DxgkDdiStartDevice.
[in] ComponentIndex
Índice del componente de energía especificado por DXGKARG_QUERYADAPTERINFO. pInputData en una llamada a la función DxgkDdiQueryAdapterInfo.
[in] Residency
La residencia esperada ( el tiempo máximo, en unidades de 100 nanosegundos) que el controlador de miniporte de pantalla espera que un componente de energía permanezca inactivo después de entrar en un estado inactivo. El Power Management Framework usa esta información para seleccionar un estado de inactividad adecuado para el componente que no infringe la residencia solicitada. La residencia esperada especificada por Residency permanece vigente hasta que el controlador vuelva a llamar a esta función para actualizarla. Vea comentarios.
Valor devuelto
Ninguno
Observaciones
Nota
El controlador de minipuerto de pantalla debe llamar a esta función solo si el tipo de componente es DXGK_POWER_COMPONENT_OTHER. El subsistema del kernel de gráficos de DirectX establece el valor de residencia esperado para otros tipos de componentes.
DXGKCB_XXX funciones se implementan mediante Dxgkrnl. Para usar esta función de devolución de llamada, llame a DxgkCbSetPowerComponentResidency a través del DXGKRNL_INTERFACE.
Si el componente de energía está en estado inactivo cuando se llama a esta función, el de Power Management Framework podría cambiar el estado F del componente para satisfacer el valor de residencia esperado especificado por Residency.
Si el controlador establece Residency en un valor de PO_FX_UNKNOWN_TIME (definido en Wdm.h), es posible que el complemento power Engine (PEP) no pueda establecer el componente en un estado F inferior a F0.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 8 (WDDM 1.2) |
| servidor mínimo admitido | Windows Server 2012 |
| de la plataforma de destino de | Escritorio |
| encabezado de | d3dkmddi.h (incluya D3dkmddi.h) |
| irQL | <= DISPATCH_LEVEL |