DXGKCB_SETPOWERCOMPONENTACTIVE Rückruffunktion (d3dkmddi.h)
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 |