DXGKCB_SETPOWERCOMPONENTLATENCY funzione di callback (d3dkmddi.h)

Un driver miniport visualizzato chiama DXGKCB_SETPOWERCOMPONENTLATENCY per impostare la tolleranza di latenza per un componente di alimentazione di tipo DXGK_POWER_COMPONENT_OTHER.

Sintassi

DXGKCB_SETPOWERCOMPONENTLATENCY DxgkcbSetpowercomponentlatency;

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

Parametri

[in] hAdapter

Handle per l'adattatore di visualizzazione. Il driver miniport visualizzato riceve l'handle dal membro DeviceHandle della struttura DXGKRNL_INTERFACE in una chiamata alla funzione DxgkDdiStartDevice .

[in] ComponentIndex

Indice del componente di alimentazione specificato da DXGKARG_QUERYADAPTERINFO. pInputData in una chiamata alla funzione DxgkDdiQueryAdapterInfo .

[in] Latency

La tolleranza di latenza , ovvero il tempo massimo, in unità di 100 nanosecondi, che il driver miniport visualizzato deve richiedere per svegliare un componente di alimentazione da uno stato inattiva. Power Management Framework usa queste informazioni per selezionare uno stato di inattività appropriato per il componente che non viola la tolleranza di latenza richiesta. La tolleranza di latenza specificata dalla latenza rimane attiva fino a quando il driver chiama nuovamente questa funzione per aggiornarla. Vedere la sezione Osservazioni.

Valore restituito

nessuno

Osservazioni

Nota

Il driver miniport visualizzato deve chiamare questa funzione solo se il tipo di componente è DXGK_POWER_COMPONENT_OTHER. Il sottosistema kernel della grafica DirectX imposta il valore di tolleranza di latenza per altri tipi di componente.

DXGKCB_XXX funzioni vengono implementate da Dxgkrnl. Per usare questa funzione di callback, chiamare DxgkCbSetPowerComponentLatency tramite la DXGKRNL_INTERFACE.

Se il componente di alimentazione si trova in uno stato inattivo quando questa funzione viene chiamata, Power Management Framework potrebbe modificare lo stato F del componente per soddisfare la tolleranza di latenza specificata dalla latenza.

Se il driver imposta latenza su un valore di PO_FX_UNKNOWN_TIME (definito in Wdm.h), il plug-in del motore di alimentazione potrebbe non essere in grado di impostare il componente su uno stato F inferiore a F0.

Requisiti

Requisito Valore
Client minimo supportato Windows 8 (WDDM 1.2)
Server minimo supportato Windows Server 2012
Piattaforma di destinazione Desktop
Intestazione d3dkmddi.h (include D3dkmddi.h)
IRQL <= DISPATCH_LEVEL

Vedi anche

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DxgkDdiQueryAdapterInfo

DxgkDdiStartDevice