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 l'adattatore di visualizzazione. Il driver 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. Power Management Framework gestisce 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 alla funzione DxgkDdiSetPowerComponentFState in un altro thread di esecuzione.
DXGKCB_XXX funzioni vengono implementate da Dxgkrnl. Per usare questa funzione di callback, chiamare DxgkCbSetPowerComponentActive tramite il DXGKRNL_INTERFACE.
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 | PASSIVE_LEVEL |