IWMDMProgress::Begin-Methode (mswmdm.h)

Artikel
02/29/2024

Die Begin-Methode gibt an, dass ein Vorgang beginnt. Eine Schätzung der Dauer des Vorgangs wird nach Möglichkeit bereitgestellt.

Syntax

HRESULT Begin(
  [in] DWORD dwEstimatedTicks
);

Parameter

[in] dwEstimatedTicks

DWORD , die die geschätzte Anzahl von Ticks angibt, die für den Abschluss des Vorgangs erforderlich sind.

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

Dieser Vorgang wird von verschiedenen Methoden aufgerufen, um anzugeben, dass ein Vorgang beginnt. Die Anzahl der in dwEstimatedTicks übergebenen Ticks ist eine Schätzung, wie viele Ticks für den Abschluss des Vorgangs benötigt werden. Während des Vorgangs wird die Progress-Methode aufgerufen, um anzugeben, wie viele Ticks transpiriert wurden. Anwendungen können die Schätzung verwenden, um Anzeigemechanismen zu konfigurieren, die den Fortschritt anzeigen.

Die IWMDMProgress3::Begin3-Methode bietet weitere Informationen dazu, welche Aktion ausgeführt wird.

Beispiele

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


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