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

  • Artículo

Un controlador de minipuerto de pantalla llama a DXGKCB_SETPOWERCOMPONENTLATENCY para establecer la tolerancia de latencia para un componente de potencia de tipo DXGK_POWER_COMPONENT_OTHER.

Sintaxis

DXGKCB_SETPOWERCOMPONENTLATENCY DxgkcbSetpowercomponentlatency;

void DxgkcbSetpowercomponentlatency(
  [in] IN_CONST_HANDLE hAdapter,
  [in] UINT ComponentIndex,
  [in] ULONGLONG Latency
)
{...}

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] Latency

La tolerancia a la latencia ( el tiempo máximo, en unidades de 100 nanosegundos) que el controlador de minipuerto de pantalla debe tardar para despertar un componente de potencia de un estado inactivo. Power Management Framework usa esta información para seleccionar un estado de inactividad adecuado para el componente que no infringe la tolerancia de latencia solicitada. La tolerancia de latencia especificada por Latency permanece en vigor hasta que el controlador llama 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 tolerancia de latencia para otros tipos de componentes.

DXGKCB_XXX funciones se implementan mediante Dxgkrnl. Para usar esta función de devolución de llamada, llame a DxgkCbSetPowerComponentLatency a través del DXGKRNL_INTERFACE.

Si el componente de energía está en estado inactivo cuando se llama a esta función, Power Management Framework podría cambiar el estado F del componente para satisfacer la tolerancia de latencia especificada por Latencia.

Si el controlador establece la latencia 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