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

Siehe auch

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DXGKCB_SETPOWERCOMPONENTIDLE

DxgkDdiQueryAdapterInfo

DxgkDdiSetPowerComponentFState

DxgkDdiStartDevice