IConsolePower::ResetIdleTimer-Methode (mmc.h)

Die ResetIdleTimer-Methode setzt die angegebenen Leerlauftimer der Energieverwaltung zurück.

Syntax

HRESULT ResetIdleTimer(
  [in] DWORD dwFlags
);

Parameter

[in] dwFlags

Die Flags, die zum Zurücksetzen von Leerlauftimern verwendet werden. Eines oder mehrere der folgenden Flags können verwendet werden. Weitere Informationen finden Sie unter SetThreadExecutionState.

ES_DISPLAY_REQUIRED

Setzt den Anzeigetimer (Monitor) im Leerlauf zurück.

ES_SYSTEM_REQUIRED

Setzt den System-Leerlauftimer zurück.

Rückgabewert

Bei erfolgreicher Ausführung wird der Rückgabewert S_OK. Diese Methode gibt S_FALSE zurück, wenn sie auf einem System aufgerufen wird, das die Energieverwaltung nicht unterstützt. Andere Rückgabewerte weisen auf einen Fehlercode hin.

Hinweise

Rufen Sie IConsolePower::ResetIdleTimer auf, anstatt SetThreadExecutionState aufzurufen. Snap-Ins dürfen die SetThreadExecutionState-Funktion nicht direkt aufrufen. Dies führt zu Konflikten, wenn mehrere Snap-Ins im selben Thread ausgeführt werden. Stattdessen sollten Snap-Ins SetExecutionState aufrufen. Das Zurücksetzen eines Leerlauftimers führt dazu, dass er bei der Nachverfolgung des Leerlaufzeitraums von vorne beginnt. Wenn ein Snap-In keinen kontinuierlichen Ausführungszustand durch Aufrufen von IConsolePower::SetExecutionState angibt, kann es in regelmäßigen Abständen ResetIdleTimer aufrufen, um die Zeit zu verlängern, bevor das System aufgerufen wird oder Energieverwaltungsroutinen angezeigt werden.

Beispiele

HRESULT hr;

// Reset both the display and system idle timers.
// pConsolePower was created previously by
// the CoCreateInstance method.
hr = pConsolePower->ResetIdleTimer(
             ES_DISPLAY_REQUIRED | ES_SYSTEM_REQUIRED);
switch (hr)
{
    case S_OK:
        OutputDebugString(_T("ResetIdleTimer: Succeeded\n"));
        break;

    case S_FALSE:
        // The system does not support power management.
        OutputDebugString(_T("ResetIdleTimer: Unsupported\n"));
        break;

    default:
        // Unexpected error occurred.
        OutputDebugString(_T("ResetIdleTimer: Failure\n"));
        break;
}

Anforderungen

Weitere Informationen

IConsolePower::SetExecutionState

SetThreadExecutionState