PDXGK_POWER_NOTIFICATION Rückruffunktion (d3dkmthk.h)
Ein Rückruf, der eine Benachrichtigung darüber bereitstellt, dass das Grafikgerät einen Übergang zum Energiezustand des Geräts durchläuft.
Syntax
PDXGK_POWER_NOTIFICATION PdxgkPowerNotification;
void PdxgkPowerNotification(
PVOID GraphicsDeviceHandle,
DEVICE_POWER_STATE NewGrfxPowerState,
BOOLEAN PreNotification,
PVOID PrivateHandle
)
{...}
Parameter
GraphicsDeviceHandle
Ein undurchsichtiges Handle, das beim Ausführen von Rückrufen für das Grafikgerät bereitgestellt werden sollte.
NewGrfxPowerState
Ein DEVICE_POWER_STATE Wert, der den neuen Grafikleistungszustand angibt, der gerade festgelegt wird.
PreNotification
Boolescher Wert, der angibt, ob eine Benachrichtigung bereitgestellt werden soll.
PrivateHandle
Ein undurchsichtiges Handle, das in Rückrufen bereitgestellt wird. Dieses Handle muss global eindeutig sein, daher sollte ein Zeiger auf die PDO oder FDO des aufrufenden Treibers verwendet werden.
Rückgabewert
Keine
Bemerkungen
Dieser Rückruf erfolgt bei PASSIVE_LEVEL. Der Treiber kann nur dann blockieren, wenn der neue Energiezustand PowerDeviceD3 ist, um die Wartung des Vorgangs abzuschließen. In diesem Fall muss der Aufruf dennoch rechtzeitig abgeschlossen werden, da er den Abschluss des gesamten Gerätestromzustands blockieren kann und eine Power Watchdog-Fehlerüberprüfung verursacht. Der Treiber darf nicht blockieren, wenn der neue Zustand PowerDeviceD0 ist. Beim Wechsel zu PowerDeviceD3 wird sowohl eine "pre"- als auch eine "post"-Benachrichtigung bereitgestellt, vorausgesetzt, dass der Übergang in der Zwischenzeit nicht abgebrochen wird. Wenn Sie in PowerDeviceD0 wechseln, wird nur eine Postbenachrichtigung bereitgestellt. Dieser Rückrufhandler kann bei Bedarf den SetSharedPowerComponentStateCb-Grafikrückruf aufrufen. Von diesem Handler sind keine weiteren Rückrufe in den Grafikkern zulässig.
Wichtig
Der anfängliche Grafikleistungszustand wird jedoch in der IOCTL-Ausgabe bereitgestellt, da es möglich ist, dass das Grafikgerät während der Registrierung einen Energiezustandsübergang durchläuft, ein Mutex um den IOCTL-Aufruf und die Analyse des ursprünglichen Zustands abgerufen werden muss, und dieser Mutex muss in dieser Rückruffunktion abgerufen werden. Auf diese Weise stellt der Rückruf die aktuellsten Zustandsinformationen bereit, falls der Zustand wechselt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 |
| Unterstützte Mindestversion (Server) | Windows Server 2012 |
| Zielplattform | Windows |
| Kopfzeile | d3dkmthk.h |
| IRQL | <= PASSIVE_LEVEL |