DXGKCB_SETPOWERCOMPONENTACTIVE Rückruffunktion (d3dkmddi.h)

Artikel
02/26/2024

Ein Display-Miniporttreiber ruft DXGKCB_SETPOWERCOMPONENTACTIVE auf, um auf eine Energiekomponente zuzugreifen. Nachdem diese Funktion zurückgegeben wurde, kann der Anzeige-Miniporttreiber die Hardwareeinstellungen der Komponente ändern.

Syntax

DXGKCB_SETPOWERCOMPONENTACTIVE DxgkcbSetpowercomponentactive;

void DxgkcbSetpowercomponentactive(
  [in] IN_CONST_HANDLE hAdapter,
  [in] UINT ComponentIndex
)
{...}

Parameter

[in] hAdapter

Ein Handle für die Grafikkarte. Der Anzeige-Miniporttreiber empfängt das Handle vom DeviceHandle-Member der DXGKRNL_INTERFACE-Struktur in einem Aufruf der DxgkDdiStartDevice-Funktion .

[in] ComponentIndex

Der von DXGKARG_QUERYADAPTERINFO angegebene Energiekomponentenindex. pInputData in einem Aufruf der DxgkDdiQueryAdapterInfo-Funktion .

Rückgabewert

Keine

Bemerkungen

Jeder Aufruf dieser Funktion muss mit einem Aufruf der funktion DXGKCB_SETPOWERCOMPONENTIDLE gekoppelt werden, um anzugeben, dass die Komponentenhardware nicht mehr benötigt wird.

Wenn diese Funktion aufgerufen wird, wird die Anzahl der aktiven Verweise der Komponente um 1 erhöht. Das Power Management Framework verwaltet die Verweisanzahl und versetzt die Komponente nur dann in einen niedrigeren F-Zustand, wenn die Verweisanzahl null ist.

Beim Aufrufen dieser Funktion erhält der Anzeige-Miniporttreiber möglicherweise einen Aufruf der DxgkDdiSetPowerComponentFState-Funktion in einem anderen Ausführungsthread.

DXGKCB_XXX Funktionen werden von Dxgkrnl implementiert. Um diese Rückruffunktion zu verwenden, rufen Sie DxgkCbSetPowerComponentActive über die DXGKRNL_INTERFACE auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 (WDDM 1.2)
Unterstützte Mindestversion (Server)	Windows Server 2012
Zielplattform	Desktop
Kopfzeile	d3dkmddi.h (einschließlich D3dkmddi.h)
IRQL	PASSIVE_LEVEL