Метод IWMDMProgress::Begin (mswmdm.h)

Статья
02/29/2024

Метод Begin указывает, что операция начинается. По возможности предоставляется оценка длительности операции.

Синтаксис

HRESULT Begin(
  [in] DWORD dwEstimatedTicks
);

Параметры

[in] dwEstimatedTicks

DWORD , указывающий предполагаемое количество тактов, необходимых для завершения операции.

Возвращаемое значение

Приложение должно вернуть одно из следующих значений HRESULT .

Код возврата	Описание
S_OK	Операция должна быть продолжена.
WMDM_E_USER_CANCELLED	Windows Media диспетчер устройств следует отменить текущую операцию, не дожидаясь ее завершения. Если приложение использует режим блокировки, диспетчер устройств Windows Media вернет эту ошибку приложению.

Эта операция вызывается различными методами, чтобы указать, что операция начинается. Количество тактов, переданных в dwEstimatedTicks , — это оценка количества тактов, необходимого для завершения операции. В ходе операции вызывается метод Progress , чтобы указать количество тактов. Приложения могут использовать оценку для настройки механизмов отображения, показывающих ход выполнения.

Метод IWMDMProgress3::Begin3 предоставляет дополнительные сведения о выполняемом действии.

Примеры

Следующий код C++ является реализацией метода Begin .


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