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 |