DXGKCB_SETPOWERCOMPONENTACTIVE funzione di callback (d3dkmddi.h)
Un driver miniport di visualizzazione chiama DXGKCB_SETPOWERCOMPONENTACTIVE per accedere a un componente di alimentazione. Al termine di questa funzione, il driver miniport di visualizzazione può modificare le impostazioni hardware del componente.
Sintassi
DXGKCB_SETPOWERCOMPONENTACTIVE DxgkcbSetpowercomponentactive;
void DxgkcbSetpowercomponentactive(
[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
Ogni chiamata a questa funzione deve essere associata a una chiamata alla funzione DXGKCB_SETPOWERCOMPONENTIDLE per indicare che l'hardware del componente non è più necessario.
Quando questa funzione viene chiamata, il conteggio dei riferimenti attivi del componente viene aumentato 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.
Durante la chiamata a questa funzione, il driver miniport di visualizzazione potrebbe ricevere una chiamata al DxgkDdiSetPowerComponentFState funzione su un altro thread di esecuzione.
DXGKCB_XXX funzioni vengono implementate da Dxgkrnl. Per usare questa funzione di callback, chiamare DxgkCbSetPowerComponentActive tramite il DXGKRNL_INTERFACE.
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 | PASSIVE_LEVEL |