DXGKCB_SETPOWERCOMPONENTIDLE funzione di callback (d3dkmddi.h)
Un driver miniport di visualizzazione chiama DXGKCB_SETPOWERCOMPONENTIDLE per notificare al sottosistema kernel della grafica DirectX che un componente di alimentazione non è più necessario. Al termine di questa funzione, il driver miniport di visualizzazione non deve modificare le impostazioni hardware del componente.
Sintassi
DXGKCB_SETPOWERCOMPONENTIDLE DxgkcbSetpowercomponentidle;
void DxgkcbSetpowercomponentidle(
[in] IN_CONST_HANDLE hAdapter,
[in] UINT ComponentIndex
)
{...}
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.
Valore restituito
Nessuno
Osservazioni
Il driver miniport di visualizzazione può chiamare questa funzione per qualsiasi tipo di componente di alimentazione, anche se il sottosistema kernel grafico DirectX gestisce lo stato di inattività del componente.
DXGKCB_XXX funzioni vengono implementate da Dxgkrnl. Per usare questa funzione di callback, chiamare DxgkCbSetPowerComponentIdle tramite il DXGKRNL_INTERFACE. Ogni chiamata a questa funzione deve essere associata a una chiamata alla funzione DXGKCB_SETPOWERCOMPONENTACTIVE.
Quando questa funzione viene chiamata, il conteggio dei riferimenti attivi del componente viene ridotto di 1. Il Power Management Framework mantiene il conteggio dei riferimenti e inserisce il componente in uno stato F inferiore solo quando il conteggio dei riferimenti diventa zero.
Questa funzione deve essere chiamata in IRQL <= DISPATCH_LEVEL. Può essere chiamato in IRQL = DISPATCH_LEVEL solo se il tipo di componente è DXGK_POWER_COMPONENT_OTHER.
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 | Vedere la sezione Osservazioni. |