DXGK_GRAPHICSPOWER_REGISTER_OUTPUT Struktur (d3dkmthk.h)

Eine Struktur, die Ausgabedaten enthält, die zum Verwalten freigegebener Energiekomponenten verwendet werden.

Syntax

typedef struct _DXGK_GRAPHICSPOWER_REGISTER_OUTPUT {
  PVOID                                  DeviceHandle;
  DEVICE_POWER_STATE                     InitialGrfxPowerState;
  PDXGK_SET_SHARED_POWER_COMPONENT_STATE SetSharedPowerComponentStateCb;
  PDXGK_GRAPHICSPOWER_UNREGISTER         UnregisterCb;
} DXGK_GRAPHICSPOWER_REGISTER_OUTPUT, *PDXGK_GRAPHICSPOWER_REGISTER_OUTPUT;

Member

DeviceHandle

Ein undurchsichtiges Handle, das beim Ausführen von Rückrufen an das Grafikgerät bereitgestellt werden sollte.

InitialGrfxPowerState

Der Energiezustand des Grafikgeräts, das vom DeviceHandle zum Zeitpunkt der internen IOCTL-Behandlung dargestellt wird. Der IOCTL-Aufruf und die Analyse dieses InitialGrfxPowerState-Elements müssen durch einen Mutex geschützt werden, der auch den PowerNotificationCb-Rückruf schützt.

SetSharedPowerComponentStateCb

Ein Rückruf, der angibt, ob die angegebene Energiekomponente aktiv ist. Der Komponentenindex sollte mit dem Index übereinstimmen, der vom Grafiktreiber verwendet wird, als die Komponente bei der Treiberinitialisierung angegeben wurde, und die Komponente muss einer der freigegebenen Energiekomponententypen sein. Wenn dieser Rückruf verwendet wird, um einen Zustand festzulegen, der bereits von diesem Treiber für dieses Grafikgerät festgelegt wurde, hat der Aufruf keine Auswirkung.

Wenn eine Komponente aktiv festgelegt wird, wird der Grafiktreiber synchron benachrichtigt, bevor dieser Rückruf zurückgegeben wird. Dieser Rückruf muss von <= APC_LEVEL aufgerufen werden. Es ist möglich, dass dieser Aufruf mit STATUS_DEVICE_REMOVED fehlschlägt, wenn das Gerät entfernt wird und RemovalNotificationCb noch nicht aufgerufen wurde oder die Grafikkarte nicht ausgeführt wird. Siehe PDXGK_SET_SHARED_POWER_COMPONENT_STATE.

UnregisterCb

Ein Rückruf zum Aufheben der Registrierung beim Grafiktreiber. Alle gemeinsam genutzten Energiekomponenten sollten nicht mehr aktiv sein. Das System verhält sich so, als ob SetSharedPowerComponentStateCb für alle aktiven freigegebenen Energiekomponenten mit dem neuen aktiven Status FALSE aufgerufen worden wäre. Nach der Rückgabe können zuvor bereitgestellte Rückrufe nicht mehr verwendet werden. Dieser Rückruf muss von <= APC_LEVEL aufgerufen werden. Siehe PDXGK_GRAPHICSPOWER_UNREGISTER.

Anforderungen