DXGKCB_SETPOWERCOMPONENTACTIVE funzione di callback (d3dkmddi.h)

Articolo
02/23/2024

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