Compartir a través de


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

Un controlador de minipuerto de pantalla llama a DXGKCB_SETPOWERCOMPONENTLATENCY para establecer la tolerancia de latencia para un componente de energía 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 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] Latency

La tolerancia a la latencia ( el tiempo máximo, en unidades de 100 nanosegundos) que el controlador de miniporte de pantalla debe tardar para despertar un componente de energía desde 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 tolerancia de latencia solicitada. La tolerancia de latencia especificada por latencia permanece en vigor hasta que el controlador llame a esta función de nuevo 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 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, el Power Management Framework podría cambiar el estado F del componente para satisfacer la tolerancia de latencia especificada por Latencia.

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

Consulte también

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

dxgkDdiQueryAdapterInfo

dxgkDdiStartDevice