DXGKCB_SETPOWERCOMPONENTACTIVE Rückruffunktion (d3dkmddi.h)
Ein Anzeige-Miniporttreiber ruft DXGKCB_SETPOWERCOMPONENTACTIVE auf, um auf eine Energiekomponente zuzugreifen. Nachdem diese Funktion zurückgegeben wurde, kann der 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 den Anzeigeadapter. Der Anzeige-Miniporttreiber empfängt den Handle vom DeviceHandle Member der DXGKRNL_INTERFACE-Struktur in einem Aufruf der DxgkDdiStartDevice--Funktion.
[in] ComponentIndex
Der durch DXGKARG_QUERYADAPTERINFOangegebene Leistungskomponentenindex.pInputData- in einem Aufruf der funktion DxgkDdiQueryAdapterInfo.
Rückgabewert
Nichts
Bemerkungen
Jeder Aufruf dieser Funktion muss mit einem Aufruf der DXGKCB_SETPOWERCOMPONENTIDLE-Funktion gekoppelt werden, um anzugeben, dass die Komponentenhardware nicht mehr erforderlich ist.
Wenn diese Funktion aufgerufen wird, wird die aktive Referenzanzahl der Komponente um 1 erhöht. Das Power Management Framework verwaltet die Referenzanzahl und platziert die Komponente nur dann in einen niedrigeren F-Zustand, wenn die Referenzanzahl null wird.
Beim Aufrufen dieser Funktion empfängt der Miniporttreiber möglicherweise einen Aufruf des DxgkDdiSetPowerComponentFState-Funktion in einem anderen Ausführungsthread.
DXGKCB_XXX Funktionen werden von Dxgkrnlimplementiert. Rufen Sie DxgkCbSetPowerComponentActive über die DXGKRNL_INTERFACEauf, um diese Rückruffunktion zu verwenden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8 (WDDM 1.2) |
| mindestens unterstützte Server- | Windows Server 2012 |
| Zielplattform- | Desktop |
| Header- | d3dkmddi.h (einschließlich D3dkmddi.h) |
| IRQL- | PASSIVE_LEVEL |