IWMDMProgress::P rogress-Methode (mswmdm.h)

Artikel
02/29/2024

Die Progress-Methode gibt an, dass ein Vorgang noch ausgeführt wird.

Syntax

HRESULT Progress(
  [in] DWORD dwTranspiredTicks
);

Parameter

[in] dwTranspiredTicks

DWORD , die die Anzahl der Bisher aufgetretenen Ticks angibt.

Rückgabewert

Die Anwendung sollte einen der folgenden HRESULT-Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Der Vorgang sollte fortgesetzt werden.
WMDM_E_USER_CANCELLED	Windows Media Geräte-Manager sollte den aktuellen Vorgang abbrechen, ohne auf den Abschluss zu warten. Wenn die Anwendung den Blockmodus verwendet, gibt Windows Media Geräte-Manager diesen Fehler an die Anwendung zurück.

Hinweise

Diese Methode wird von allen anderen Windows Media Geräte-Manager-Methoden aufgerufen. Die Absicht ist, dass Fortschritt einmal pro geschätztem Tick aufgerufen wird. Der dwTranspiredTicks-Parameter muss jedoch bei jedem Aufruf überprüft werden, da der ausgeführte Vorgang möglicherweise keinen einmaligen Aufruf für jeden geschätzten Tick garantiert.

Die Anwendung gibt S_OK an die aufrufende Methode zurück, um anzugeben, dass der Vorgang fortgesetzt werden soll. Die Anwendung gibt WMDM_E_USER_CANCELLED zurück, um anzugeben, dass der Vorgang abgebrochen werden soll. Wenn die Anwendung den Blockmodus verwendet und WMDM_E_USER_CANCELLED zurückgibt, gibt Windows Media Geräte-Manager denselben Fehler an die Anwendung zurück.

Beispiele

Der folgende C++-Code ist eine einfache Implementierung der Progress-Methode .


HRESULT Progress(DWORD  dwTranspiredTicks)
{
    // TODO: Display the message: "IWMDMProgress::Progress called" 
    // followed by the dwTranspiredTicks value.
    return S_OK;
}