DXGKCB_SETPOWERCOMPONENTRESIDENCY función de devolución de llamada (d3dkmddi.h)

  • Artículo

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

Consulte también

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DxgkDdiQueryAdapterInfo

DxgkDdiStartDevice