DXGKCB_SETPOWERCOMPONENTRESIDENCY función de devolución de llamada (d3dkmddi.h)
Un controlador de miniporte de pantalla en modo kernel llama 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 minipuerto 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 minipuerto de pantalla espera que un componente de energía permanezca inactivo después de que entre en estado inactivo. 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 en vigor hasta que el controlador llame a esta función de nuevo para actualizarla. Vea la sección Comentarios.
Valor devuelto
None
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 un estado inactivo cuando se llama a esta función, 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 de Power Engine (PEP) no pueda establecer el componente en un estado F inferior a F0.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8 (WDDM 1.2) |
| Servidor mínimo compatible | Windows Server 2012 |
| Plataforma de destino | Escritorio |
| Encabezado | d3dkmddi.h (incluya D3dkmddi.h) |
| IRQL | <= DISPATCH_LEVEL |