DXGKCB_SETPOWERCOMPONENTLATENCY funzione di callback (d3dkmddi.h)
Un driver miniport di visualizzazione 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 la scheda di visualizzazione. Il driver del miniport di visualizzazione riceve l'handle dal membro DeviceHandle della struttura DXGKRNL_INTERFACE in una chiamata alla relativa 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 del miniport di visualizzazione deve impiegare per risvegliare un componente di alimentazione da uno stato di inattività. Il 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 da latenza rimane attiva fino a quando il driver non chiama nuovamente questa funzione per aggiornarla. Vedere la sezione Osservazioni.
Valore restituito
Nessuno
Osservazioni
Nota
Il driver display miniport 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 componenti.
DXGKCB_XXX funzioni vengono implementate da Dxgkrnl. Per usare questa funzione di callback, chiamare DxgkCbSetPowerComponentLatency tramite il DXGKRNL_INTERFACE.
Se il componente di alimentazione si trova in uno stato di inattività quando questa funzione viene chiamata, il Power Management Framework potrebbe modificare lo stato F del componente per soddisfare la tolleranza di latenza specificata da 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.
Fabbisogno
| 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 |