DXGKCB_SETPOWERCOMPONENTRESIDENCY funzione di callback (d3dkmddi.h)
Un driver miniport in modalità kernel chiama DXGKCB_SETPOWERCOMPONENTRESIDENCY per impostare la residenza prevista per un componente di alimentazione di tipo DXGK_POWER_COMPONENT_OTHER.
Sintassi
DXGKCB_SETPOWERCOMPONENTRESIDENCY DxgkcbSetpowercomponentresidency;
void DxgkcbSetpowercomponentresidency(
[in] IN_CONST_HANDLE hAdapter,
[in] UINT ComponentIndex,
[in] ULONGLONG Residency
)
{...}
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] Residency
La residenza prevista, ovvero il tempo massimo, in unità di 100 nanosecondi, che il driver di miniport di visualizzazione prevede che un componente di alimentazione rimanga inattivo dopo che entra in 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 residenza richiesta. La residenza prevista specificata da Residenza 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 residenza previsto per altri tipi di componenti.
DXGKCB_XXX funzioni vengono implementate da Dxgkrnl. Per usare questa funzione di callback, chiamare DxgkCbSetPowerComponentResidency tramite il DXGKRNL_INTERFACE.
Se il componente di alimentazione si trova in uno stato di inattività quando questa funzione viene chiamata, il di Power Management Framework potrebbe modificare lo stato F del componente per soddisfare il valore di residenza previsto specificato da Residenza.
Se il driver imposta Residency su un valore di PO_FX_UNKNOWN_TIME (definito in Wdm.h), il plug-in del motore di alimentazione (PEP) 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 |